Pular para o conteúdo
NexoNexo · API e MCP

Atividade da API e do MCP

GET
/v1/activity
curl --request GET \
  --url 'https://developers.nexo.winningsales.com.br/v1/activity?limit=50' \
  --header 'Authorization: Bearer <token>'

Registro de auditoria da empresa: criação e revogação de tokens, toda leitura de conversa na íntegra, exportações e toda chamada negada, com quem, por qual token, por onde (REST, CLI, MCP) e o resultado. Só administradores.

Authorizations

Seção intitulada “Authorizations”

Parameters

Seção intitulada “Parameters”

Query Parameters

Seção intitulada “Query Parameters”
userId

Só a atividade desta pessoa

string format: uuid

Só a atividade desta pessoa

credentialId

Só a atividade deste token

string format: uuid

Só a atividade deste token

cursor

Cursor devolvido em nextCursor para buscar a página seguinte

string
>= 1 characters

Cursor devolvido em nextCursor para buscar a página seguinte

limit

Itens por página (1 a 200)

integer
default: 50 >= 1 <= 200

Itens por página (1 a 200)

Responses

Seção intitulada “Responses”

200

Seção intitulada “200”

Página de registros, mais novos primeiro

Media typeapplication/json
object
data
required

Registros, mais novos primeiro

Array<object>
object
id
required

Id do registro

string format: uuid
at
required

Quando aconteceu

string format: date-time
userId
required

Pessoa dona do token

string format: uuid
nullable
userName
required

Nome da pessoa

string
nullable
credentialId
required

Token usado

string format: uuid
nullable
surface
required

Por onde veio: app, REST, CLI ou MCP

string
Allowed values: app rest cli mcp
operation
required

Operação (ex.: conversations.reading, tokens.create)

string
resourceType
required

Tipo do recurso acessado

string
nullable
resourceId
required

Id do recurso acessado

string
nullable
outcome
required

Resultado

string
Allowed values: ok denied error rate_limited
status
required

Status HTTP da resposta

integer
reason
required

Motivo, quando há (ex.: user_deactivated na revogação de token pela inativação da pessoa)

string
nullable
nextCursor
required

Cursor da próxima página. Nulo quando acabou

string
nullable

Example 

{
  "data": [
    {
      "surface": "app",
      "outcome": "ok"
    }
  ]
}

400

Seção intitulada “400”

Filtro ou cursor inválido

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

401

Seção intitulada “401”

Token ausente, inválido, expirado ou revogado

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example 

{
  "type": "public_api.invalid_credential",
  "title": "InvalidCredentialError",
  "status": 401,
  "detail": "Token de acesso inválido, expirado ou revogado. Crie um novo token de acesso no Nexo.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb"
}

403

Seção intitulada “403”

Papel, escopo do token ou plano não permitem a operação

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example 

{
  "type": "public_api.insufficient_scope",
  "title": "InsufficientScopeError",
  "status": 403,
  "detail": "Este token não tem o escopo conversations:read, exigido por esta operação. Gere um token com esse escopo.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb",
  "meta": {
    "operation": "conversations.reading",
    "scope": "conversations:read"
  }
}

429

Seção intitulada “429”

Limite de chamadas da empresa ou do token atingido

Media typeapplication/json
object
type
required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string
title
required

Error class name

string
status
required

HTTP status code

integer
detail
required

Human-readable message, safe to display to end users

string
requestId
required

Correlation id — send it to support to locate the full trail

string
nullable
meta

Structured details safe for the frontend (field errors, ids)

object
key
additional properties

Example 

{
  "type": "public_api.rate_limited",
  "title": "PublicRateLimitedError",
  "status": 429,
  "detail": "Muitas chamadas em pouco tempo. Tente de novo em 12 segundos.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb",
  "meta": {
    "class": "content",
    "limitedBy": "company",
    "limit": 120,
    "windowSeconds": 60,
    "retryAfterSeconds": 12
  }
}