# info.description
Organization-scoped operations for one managed workflow. Production access requires OAuth; this specification contains no client data.

# externalDocs.description
Second Shift Agents API and MCP developer documentation

# paths./api/v1/preflights.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/me.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/overview.get.summary
Read attention queue and workflow overview

# paths./api/v1/overview.get.description
Read attention queue and workflow overview

# paths./api/v1/overview.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/workflows.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/workflows/{workflowId}.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/workflows/{workflowId}/operations.post.summary
Start, pause, or request a workflow change

# paths./api/v1/workflows/{workflowId}/operations.post.description
Start, pause, or request a workflow change

# paths./api/v1/workflows/{workflowId}/operations.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/approvals.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/approvals/{approvalId}/decision.post.description
A delegated agent requires approvals:write for the approval's workflow.

# paths./api/v1/approvals/{approvalId}/decision.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/work-requests.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/usage.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/invoices.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/messages.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/messages.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/documents.get.parameters[].description
Limit results to one authorized workflow.

# paths./api/v1/documents.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/documents.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/documents/{documentId}/content.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/notifications.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/notification-preferences.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/notification-preferences.patch.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/billing/checkout.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/billing/checkout.post.responses.200.description
Stripe-hosted checkout or private staging preview

# paths./api/v1/members.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/invitations.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/invitations.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/agent-identities.post.description
Owner only. Registration does not grant workflow authority.

# paths./api/v1/agent-identities.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/agent-identities.get.summary
List registered external agent identities

# paths./api/v1/agent-identities.get.description
List registered external agent identities

# paths./api/v1/agent-identities.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/agent-grants.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/agent-grants.post.summary
Grant scopes to an external agent for one workflow

# paths./api/v1/agent-grants.post.description
Owner only. approvals:write is never organization-wide.

# paths./api/v1/agent-grants.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/agent-grants/{grantId}/revoke.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/workflows/{workflowId}/client-ready.post.summary
Confirm readiness for the seven-day live test

# paths./api/v1/workflows/{workflowId}/client-ready.post.description
Owner or admin only; deployment and required connections must already be verified by Second Shift.

# paths./api/v1/workflows/{workflowId}/client-ready.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/workflows/{workflowId}/client-ready.post.responses.200.description
Testing started without starting the monthly subscription

# paths./api/v1/export.get.description
Owner or admin only. Available during the 30-day recovery window.

# paths./api/v1/export.get.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/v1/sandbox/preflights.post.description
Validates and echoes a synthetic workflow description without persistence, credentials, client-data access, or external effects.

# paths./api/v1/sandbox/preflights.post.parameters[].description
Optional caller-supplied UUID used to correlate a request

# paths./api/private/commerce/mpp/offer.get.description
Returns a disabled, non-settling payment challenge for protocol discovery; it cannot settle money.

# components.securitySchemes.oauth2.flows.authorizationCode.scopes.workflows:operate
Start or pause routine operation and request changes

# components.securitySchemes.oauth2.flows.authorizationCode.scopes.approvals:write
Decide approvals within an explicit workflow grant

# components.securitySchemes.oauth2.flows.authorizationCode.scopes.billing:write
Create checkout with verified billing authority

# components.securitySchemes.oauth2.flows.authorizationCode.scopes.agents:manage
Owner-only registration and workflow grants for external agents

# components.schemas.SuccessObject.description
Operation-specific JSON object. Stable fields are documented by the implementing service and compatible additions may be introduced.

# components.headers.RateLimitPolicy.description
Structured rate-limit policy for the public API