---
title: "Get approval"
method: GET
path: "/v1/projects/{project_id}/approvals/{approval_id}"
tags: ["approvals"]
---

# Get approval

`GET /v1/projects/{project_id}/approvals/{approval_id}`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/approvals/{approval_id}`
- Auth: HTTP bearer

Get one tool-call approval request.

Required permission: `approvals.view`.

## Path parameters

- `project_id` string, uuid, required
- `approval_id` string, uuid, required

## Response `200`

Successful Response

- ApprovalResponse: A paused tool call that waits for a human to approve it or provide input.
  - `id` string, uuid, required
  - `run_id` string, uuid, required: Run that is paused until the request is decided.
  - `environment_id` string, uuid, required: Environment of the run.
  - `agent_name` string, required: Agent that made the tool call.
  - `tool_name` string, required: Tool the agent wants to call.
  - `tool_params` object, nullable: Arguments of the pending tool call.
  - `message` string, nullable: Message for reviewers from the agent's approval settings.
  - `response_label` string, nullable: Label of the text a reviewer must provide when approving. Set for human input requests; null for plain approvals.
  - `response_sensitive` boolean: Whether the reviewer's response is redacted from recorded run data.
  - `timeout` integer, required: Seconds the request waits for a decision before it times out (30 to 604800).
  - `on_rejection` string: What happens on rejection or timeout: `fail` ends the run, `continue` resumes it and tells the agent the call was not approved.
  - `status` 'pending' | 'approved' | 'rejected' | 'timeout', required: `pending` until decided. `timeout` when no decision arrived in time or the run ended first.
  - `created_at` string, date-time, required
  - `resolved_at` string, date-time, nullable: When the request was resolved. null while pending.
  - `resolved_by_id` string, nullable: ID of the user who decided, or a system value such as `system` for automatic resolutions. null while pending.
  - `resolved_by` string, nullable: Email of the user who decided, or a system value for automatic resolutions. null while pending.
  - `reason` string, nullable: Note given with the decision, or why the request was closed automatically. null when none.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `404`: The resource does not exist in this project.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/connic/apis/connic-api.md) · [All operations](https://skmtc.dev/connic/apis/connic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/connic/apis/connic-api/revisions/482932da5fbe?raw)