Skip to content

docs: document /stop/{kickoff_id} endpoint for cancelling executions#5208

Open
iris-clawd wants to merge 2 commits into
mainfrom
docs/stop-execution-endpoint
Open

docs: document /stop/{kickoff_id} endpoint for cancelling executions#5208
iris-clawd wants to merge 2 commits into
mainfrom
docs/stop-execution-endpoint

Conversation

@iris-clawd
Copy link
Copy Markdown
Contributor

@iris-clawd iris-clawd commented Apr 1, 2026

Document the existing /stop/{kickoff_id} API endpoint that allows stopping running crew and flow executions. This endpoint exists in crewAI-enterprise but was not previously documented in the public docs or OpenAPI spec.

Changes

  • docs/en/enterprise/guides/kickoff-crew.mdx: Added "Stopping a Running Execution" section with API usage examples, success/error responses, and notes about terminal states.
  • docs/enterprise-api.base.yaml and docs/enterprise-api.en.yaml: Added /stop/{kickoff_id} endpoint to OpenAPI spec with full request/response documentation and StopExecutionResponse schema.
  • docs/enterprise-api.ko.yaml: Added localized stop endpoint and schema (Korean).
  • docs/enterprise-api.pt-BR.yaml: Added localized stop endpoint and schema (Brazilian Portuguese).
  • Updated API workflow descriptions to include the stop step.

Note

Low Risk
Low risk: documentation/OpenAPI-only updates with no runtime code changes. Main risk is mismatched endpoint behavior across locales/specs if the documented responses/status codes diverge from the implementation.

Overview
Documents the existing POST /stop/{kickoff_id} endpoint for cancelling a running crew/flow execution, including request/response examples and terminal-state constraints.

Adds the /stop/{kickoff_id} path and StopExecutionResponse schema to the OpenAPI specs (enterprise-api.base.yaml/enterprise-api.en.yaml) and localizes the endpoint in enterprise-api.ko.yaml and enterprise-api.pt-BR.yaml, plus new API reference pages (*/api-reference/stop.mdx) and navigation entries in docs.json.

Written by Cursor Bugbot for commit 0650d19. This will update automatically on new commits. Configure here.

@mintlify
Copy link
Copy Markdown

mintlify Bot commented Apr 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
crewai 🟢 Ready View Preview Apr 1, 2026, 1:39 PM

@lorenzejay
Copy link
Copy Markdown
Collaborator

@bragamat @iris-clawd I checked the built preview and our reference to /stop endpoint is not there. it should have its own page like api-reference/kickoff

Screenshot 2026-04-01 at 9 48 18 AM

https://your-crew-url.crewai.com/status/abcd1234-5678-90ef-ghij-klmnopqrstuv
```

## Stopping a Running Execution
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@bragamat @iris-clawd I checked the built preview and our reference to /stop endpoint is not there. it should have its own page like api-reference/kickoff

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

iris-clawd and others added 2 commits April 2, 2026 13:11
Address review feedback to create a dedicated stop endpoint page
in api-reference, matching the pattern used by kickoff endpoint.
Added stop.mdx for all languages (en, ko, pt-BR, ar) and updated
docs.json navigation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants