> ## Documentation Index > Fetch the complete documentation index at: https://docs.niadra.com/llms.txt > Use this file to discover all available pages before exploring further. # Desfechos atribuídos > Cada desfecho atribuído ao que um agente fez, do mais novo para o mais antigo, com o método, a faixa e a finalidade. Funcionalidade `measurement`. ## OpenAPI ````yaml openapi/pt/cell.json GET /v1/measure/outcomes openapi: 3.1.0 info: title: API de dados da Niadra version: '1' description: >- Escrita, contexto, histórico, objetos, identidade, privacidade e governança de um espaço. Cada espaço tem um endereço estável, com o espaço e a região no nome. servers: - url: https://{space}.{region}.api.niadra.com variables: space: default: acme-prod description: O espaço, que vem na chave de fonte. region: default: us-east-2 description: A região do espaço, que também vem na chave. security: [] paths: /v1/measure/outcomes: get: tags: - signals summary: Desfechos atribuídos description: >- Desfechos atribuídos ao que os agentes fizeram, do mais novo para o mais antigo: cada vínculo com o método, a faixa e a finalidade. **Autenticação.** Token de pessoa do Console com o papel `analysis` (ou admin), ou chave de fonte com o escopo `admin`. Só responde num espaço com a funcionalidade `measurement` ligada (o documento `features`); num espaço sem ela, 404. operationId: outcomes_v1_measure_outcomes_get parameters: - in: query name: cursor required: false schema: anyOf: - maxLength: 200 type: string - type: 'null' title: Cursor description: Cursor opaco, vindo de `next_cursor`. - in: query name: limit required: false schema: default: 50 maximum: 200 minimum: 1 title: Limit type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/OutcomePage' description: Resposta de sucesso. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: O pedido não bate com o contrato. security: - sourceKey: [] - personToken: [] components: schemas: OutcomePage: additionalProperties: false properties: items: items: $ref: '#/components/schemas/OutcomeLink' title: Items type: array next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor required: - items title: OutcomePage type: object Problem: additionalProperties: false description: >- Detalhes do problema no formato da RFC 9457; `code` vem do catálogo de erros versionado. properties: code: title: Code type: string detail: anyOf: - type: string - type: 'null' default: null title: Detail request_id: anyOf: - type: string - type: 'null' default: null title: Request Id status: title: Status type: integer title: title: Title type: string type: default: about:blank title: Type type: string required: - title - status - code title: Problem type: object OutcomeLink: additionalProperties: false description: >- Um desfecho atribuído ao que um agente fez, por um método. `line` e `order` são determinísticos: o token de exposição que a linha do pedido ou o pedido levou, ou a própria ação do agente sobre o objeto. `identity` e `assisted_handoff` são prováveis: o mesmo item engajado ou mostrado numa janela, ou uma transferência que ajudou a venda. Um vínculo leva o valor da linha inteiro ou nenhum: um valor nunca é ponderado. properties: action_id: anyOf: - maxLength: 512 minLength: 1 type: string - type: 'null' title: Action Id agent: anyOf: - maxLength: 256 minLength: 1 type: string - type: 'null' title: Agent band: enum: - deterministic - probable title: Band type: string confidence: anyOf: - type: number - type: 'null' description: >- De um vínculo `identity`: com que frequência esse método nomeia a exposição que o token da própria linha nomeia neste espaço, onde os dois existem. Ao lado do valor, nunca multiplicado por ele. title: Confidence currency: anyOf: - maxLength: 256 minLength: 1 type: string - type: 'null' title: Currency exposure_id: anyOf: - maxLength: 512 minLength: 1 type: string - type: 'null' title: Exposure Id final_at: anyOf: - format: date-time type: string - type: 'null' description: Quando um vínculo provisório vira final. title: Final At finality: description: >- `provisional` até a janela de troca fechar ou o objeto chegar a um estado final; `expired_without_outcome` quando o prazo dele passou antes. enum: - provisional - final - expired_without_outcome title: Finality type: string handoff_id: anyOf: - maxLength: 512 minLength: 1 type: string - type: 'null' title: Handoff Id known_at: format: date-time title: Known At type: string line: anyOf: - maxLength: 256 minLength: 1 type: string - type: 'null' title: Line link_id: maxLength: 512 minLength: 1 title: Link Id type: string method: enum: - line - order - identity - assisted_handoff title: Method type: string object: pattern: ^[a-z][a-z0-9_]{0,39}:[^:\s]{1,256}:\S{1,512}$ title: Object type: string outcome: description: A definição de desfecho do documento `measurement`. maxLength: 256 minLength: 1 title: Outcome type: string position: anyOf: - type: integer - type: 'null' title: Position state: description: O estado em que o objeto ou a linha dele está. maxLength: 256 minLength: 1 title: State type: string turn_id: anyOf: - maxLength: 512 minLength: 1 type: string - type: 'null' title: Turn Id valid_at: description: Quando o desfecho passou a contar. format: date-time title: Valid At type: string value_minor: anyOf: - type: integer - type: 'null' description: 'Nas unidades menores da moeda; ausente: nenhum.' title: Value Minor required: - link_id - outcome - object - state - method - band - finality - valid_at - known_at title: OutcomeLink type: object securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... personToken: type: http scheme: bearer bearerFormat: JWT ````