Conga

Conga Requests API

The Requests API from Conga — 27 operation(s) for requests.

GitHub OpenAPI

Operations 28

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/requests/attachments Get attachments for several approval requests · Get the approval request attachments #
Ask an LLM
“What files are attached to these approval requests?”
“Can I pull the attachments for a batch of approval request IDs at once?”
Tell an agent
Fetch the attachments for the approval requests I'm listing.
Show me every file attached to this set of approval requests.
POST /v1/requests/bulk-approve Approve several approval requests at once · Approve requests #
Ask an LLM
“Can I approve a whole batch of pending approval requests in one call?”
“What happens to the approval process after I bulk-approve requests?”
Tell an agent
Bulk-approve all of the approval requests on my list.
Approve these pending requests together and move each process to its next approver.
POST /v1/requests/bulk-reassign Reassign several approval requests at once · Reassign requests #
Ask an LLM
“Is there a way to hand off many approval requests to someone else in one go?”
“Can I bulk-reassign approval requests when an approver is out?”
Tell an agent
Bulk-reassign these approval requests to a new approver.
Move all of the listed approval requests off my queue in one batch.
POST /v1/requests/bulk-reject Reject several approval requests at once · Reject approval requests #
Ask an LLM
“Can I reject a batch of approval requests in a single call?”
“How do I decline many approval requests together in Conga Approvals?”
Tell an agent
Bulk-reject every approval request on this list.
Decline all of these pending approval requests at once.
POST /v1/requests/bulk/{actionType} Run an action on many business objects in bulk · Bulk business object operations #
Ask an LLM
“Can I apply one approval action type across many business objects in bulk?”
“Which bulk action types can be run against business objects?”
Tell an agent
Run the {actionType} action on these business objects in bulk.
Bulk-process the selected business objects with action type {actionType}.
POST /v1/requests/check-required Check which objects require approval · Check for objects requiring approval #
Ask an LLM
“Does this quote and its line items need approval before I continue?”
“Which header and child objects require approval right now?”
Tell an agent
Check whether header object {header} and its children need approval.
List which of these child objects {children} require approval, synchronously.
POST /v1/requests/check-required-async Check asynchronously which objects need approval · Check for objects requiring approval asynchronously #
Ask an LLM
“Can I run the approval-required check asynchronously for a large object?”
“Is there a background version of the check for objects requiring approval?”
Tell an agent
Start an async check of whether header object {header} needs approval.
Queue an asynchronous approval-required check for child objects {children}.
PUT /v1/requests/comments Add a comment to approval requests · Add comment to approval request #
Ask an LLM
“Can I leave a comment on an approval request without approving or rejecting it?”
“Is it possible to attach files along with a comment on approval requests?”
Tell an agent
Add the comment "{comments}" to approval requests {requestIds}.
Comment "{comments}" on request {requestIds} and attach files {attachmentIds}.
POST /v1/requests/process-escalation-reminders Trigger due approval reminders and escalations · Process escalation reminder jobs #
Ask an LLM
“How do I fire off all the approval reminders and escalations that are due?”
“Can I manually run the escalation reminder job for overdue approvals?”
Tell an agent
Process every approval reminder and escalation that is currently due.
Send the overdue approval reminder emails now.
PUT /v1/requests/rfi Request more information on an approval request · Reqeust an information about approval request #
Ask an LLM
“Can I ask someone for more information before deciding on an approval request?”
“Who can receive a request for information on an approval, a user or a group?”
Tell an agent
Send a request for information on approval {requestIds} to {recipient} asking "{comments}".
Ask {recipient} (a {recipientType}) for details on approval requests {requestIds}.
POST /v1/requests/submit Submit an object for approval · Submit for approval #
Ask an LLM
“How do I send a quote or opportunity into the approval process?”
“Can I submit an object for approval using its external ID instead?”
Tell an agent
Submit {objectType} {objectId} for approval.
Submit {objectType} {objectId} for approval with the comment "{comments}".
POST /v1/requests/submit-async Submit many objects for approval asynchronously · Submit an approval asynchronously #
Ask an LLM
“Can I submit a large batch of objects for approval in the background?”
“What's the async way to kick off approvals for lots of records at once?”
Tell an agent
Submit these approval requests asynchronously: {requests}.
Queue a background approval submission for the records in {requests}.
GET /v1/requests/{correlationId}/status Check status of an async approval submission · Get an approval request status #
Ask an LLM
“Did my asynchronous approval submission finish yet?”
“Where do I check progress using the correlation ID from an async submit?”
Tell an agent
Get the status of the approval submission with correlation ID {correlationId}.
Check whether async approval job {correlationId} has completed.
PUT /v1/requests/{id}/adhoc-approver Add an ad hoc approver to a running approval · Add an ad hoc approver #
Ask an LLM
“Can I insert an extra approver into an approval cycle that's already running?”
“Where in the step order can an ad hoc approver be added?”
Tell an agent
Add ad hoc approver step {step} to approval request {id} at position {position}.
Insert a new approver {step} {position} reference request {ref} on approval {id}.
DELETE /v1/requests/{id}/adhoc-approver Remove an ad hoc approver from an approval · Delete an ad hoc approver #
Ask an LLM
“Can I take back an ad hoc approver I added to a rule-based approval?”
“Is it possible to remove an extra approver from a running approval cycle?”
Tell an agent destructive · confirm first
Remove the ad hoc approver from approval request {id}.
Delete the extra approver I added on request {id}.
POST /v1/requests/{id}/approve Approve a single approval request · Approve a request #
Ask an LLM
“How do I approve one approval request and add a comment?”
“What happens next after I approve a single request in the cycle?”
Tell an agent
Approve approval request {id}.
Approve request {id} with the comment "{comments}".
POST /v1/requests/{id}/escalate Escalate an approval request · Escalate an approval request #
Ask an LLM
“Can I push a stalled approval request up to the escalation level?”
“Who does an escalated approval request go to?”
Tell an agent
Escalate approval request {id}.
Raise request {id} to its configured escalation approver.
POST /v1/requests/{id}/reassign Reassign one approval request · Reassign an approval request #
Ask an LLM
“Can I hand a single approval request to a different user or group?”
“What details do I need to reassign one approval request?”
Tell an agent
Reassign approval request {id} to {assigneeType} {assigneeId}.
Give request {id} to assignee {assigneeId} ({assigneeType}) noting "{comments}".
POST /v1/requests/{id}/reject Reject a single approval request · Reject an approval request #
Ask an LLM
“How do I reject one approval request with a reason?”
“Can a rejection be recorded as coming from an email response?”
Tell an agent
Reject approval request {id}.
Reject request {id} with the comment "{comments}".
GET /v1/requests/{objectType}/{objectId} Get the approval status of a record · Get status for a context object #
Ask an LLM
“Is this opportunity still in preview or has it been submitted for approval?”
“What approval status does a given record currently have?”
Tell an agent
Check the approval status of {objectType} {objectId}.
Tell me whether {objectType} with external ID {objectId} is previewed or submitted.
GET /v1/requests/{objectType}/{objectId}/child/{childObjectType} Get approval status of a record's child objects · Get child object approval status #
Ask an LLM
“Have the line items under this quote been submitted for approval?”
“Can I check the approval status of child objects of a record?”
Tell an agent
Check the approval status of {childType} children of {objectType} {objectId}.
Report whether the {childType} records under {objectType} {objectId} are previewed or submitted.
GET /v1/requests/{objectType}/{objectId}/comments List comments on a record's approval requests · Get approval request comments #
Ask an LLM
“What comments have approvers left on this record's approvals?”
“Can I sort approval comments oldest-first or limit them to one request?”
Tell an agent
Show the approval comments on {objectType} {objectId}.
List comments for request {requestId} on {objectType} {objectId} in {order} order.
GET /v1/requests/{objectType}/{objectId}/preview Preview which approvals a record would trigger · Preview an approval #
Ask an LLM
“Which approval processes would apply if I submitted this opportunity?”
“Can I see the approvers a record would need before submitting it?”
Tell an agent
Preview the approvals for {objectType} {objectId}.
Show me who would need to approve {objectType} {objectId} before I submit it.
POST /v1/requests/{objectType}/{objectId}/recall Recall a record's approval cycle · Recall approval requests #
Ask an LLM
“How do I cancel an approval cycle I already submitted?”
“Will approvers be notified when I recall an approval?”
Tell an agent destructive · confirm first
Recall the approval cycle on {objectType} {objectId}.
Cancel approvals for {objectType} {objectId} with the note "{comments}".
GET /v1/requests/{objectType}/{objectId}/{assigneeId} List a record's approval requests for one assignee · Get requests by assignee and object ID #
Ask an LLM
“Which approval requests on this record are assigned to a particular person?”
“What does a specific approver have pending on this object?”
Tell an agent
List approval requests on {objectType} {objectId} assigned to {assigneeId}.
Show what assignee {assigneeId} must approve on {objectType} {objectId}.
GET /v1/requests/{requestId} Get an approval request by ID · Get an approval request #
Ask an LLM
“What are the details of a specific approval request?”
“Can I look up one approval request directly by its request ID?”
Tell an agent
Get approval request {requestId}.
Show me the full details of approval request {requestId}.
PUT /v1/requests/{requestId}/assign-owner Take ownership of a queued approval request · Take ownership of an approval request #
Ask an LLM
“Can I claim a queued approval request so it's assigned to me?”
“How do I take ownership of an approval sitting in a queue?”
Tell an agent
Assign queued approval request {requestId} to me.
Claim ownership of request {requestId} from the queue.
GET /v1/requests/{requestId}/consolidation-info Get consolidation details for an approval request · Get consolidation information for an approval request #
Ask an LLM
“Which approval requests were consolidated together with this one?”
“Can I see the consolidation info for a given approval request?”
Tell an agent
Get the consolidation info for approval request {requestId}.
List the requests consolidated with approval {requestId}.

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/authentication/conga-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/rate-limits/conga-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/openapi/conga-requests-api-openapi.yml

Other Resources

🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/data-model/conga-data-model.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/scopes/conga-scopes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/conventions/conga-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/errors/conga-problem-types.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/lifecycle/conga-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/conformance/conga-conformance.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/sandbox/conga-sandbox.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/asyncapi/conga-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/conga:conga-requests-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

conga-requests-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Approvals Requests API
  description: The Approvals API is used to submit, preview, and retrieve approval processes.
  version: v1
servers:
- url: https://rls.congacloud.com/api/approvals
security: []
tags:


# --- truncated at 32 KB (105 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/openapi/conga-requests-api-openapi.yml