Skip to main content
POST
Sobe um material (criativo) do programa

Authorizations

Authorization
string
header
required

Chave de API (prefixo rstr_) enviada como Authorization: Bearer rstr_....

Path Parameters

programId
string
required
Pattern: ^prog_[0-9A-HJKMNP-TV-Z]{26}$

Response

201 - application/json

Default Response

id
string
required

Identificador único do material (prefixo mat_ + ULID).

Example:

"mat_01J9ZK8QF3N2P5R7T9V1W3X5Y7"

organizationId
string
required

Identificador da organização dona do material.

Example:

"org_01J9ZK8QF3N2P5R7T9V1W3X5Y7"

programId
string
required

Identificador do programa ao qual o material pertence.

Example:

"prog_01J9ZK8QF3N2P5R7T9V1W3X5Y7"

name
string
required

Nome do criativo exibido na lista.

Required string length: 1 - 120
Example:

"Banner — Quadrado"

format
string | null
required

Rótulo livre do formato, ou null.

Example:

"1080×1080"

fileName
string
required

Nome original do arquivo enviado.

Example:

"banner-quadrado.png"

contentType
string
required

MIME type do arquivo armazenado.

Example:

"image/png"

fileSizeBytes
integer
required

Tamanho do arquivo em bytes.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

184320

fileUrl
string
required

URL pública estável para exibir/baixar o arquivo.

Example:

"https://api.userepass.com/programs/prog_01J9ZK8QF3N2P5R7T9V1W3X5Y7/materials/mat_01J9ZK8QF3N2P5R7T9V1W3X5Y7/file"

status
enum<string>
required

Status do material: active (visível aos afiliados) ou archived (oculto, arquivo preservado).

Available options:
active,
archived
Example:

"active"

createdAt
string<date-time>
required

Data de criação do material (ISO-8601).

Example:

"2026-06-13T12:00:00.000Z"

updatedAt
string<date-time>
required

Data da última atualização do material (ISO-8601).

Example:

"2026-06-13T12:00:00.000Z"