Add tags to a document

curl --request POST \
  --url https://api.prod.payana.cloud/public/api/v1/documents/{reference}/tags \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "tags_text": [
    "centro-costo-42",
    "urgente"
  ]
}
'

{
  "message": "Tags stored successfully"
}

Documentos

Add Document Tags

Agrega etiquetas a un documento por nombre. Los nombres que no existan en tu compañía se crean automáticamente.

Aditivo: no reemplaza las etiquetas existentes; solo agrega las que el documento aún no tiene.
Idempotente por etiqueta: repetir el mismo nombre no duplica la etiqueta en el documento.
Las etiquetas también se propagan a los pagos asociados al documento.
Tras agregar etiquetas, GET /documents/{reference} y el listado las reflejan en el campo tags.
Para el tag de sistema admitido, preferí POST /documents/{reference}/acknowledge si solo necesitás marcar el documento como admitido.

POST

documents

{reference}

Authorizations

api-key

string

header

required

API key provista por Payana.

Path Parameters

reference

string

required

Referencia interna del documento en Payana (UUID, ej. aaea7db4-647c-4d92-9f86-89e34a68e1aa).

Body

application/json

tags_text

string[]

required

Nombres de etiquetas a agregar al documento. Se crean en Payana si aún no existen para tu compañía.

Minimum array length: 1

Response

Tags stored successfully

message

string

required

Example:

"Tags stored successfully"

⌘I

Documentation Index

Authorizations

Path Parameters

Body

Response