Skip to content

docs(openapi): add 402 response to Actor execution endpoints#2412

Open
tobice wants to merge 2 commits intomasterfrom
docs/add-402-actor-execution-endpoints
Open

docs(openapi): add 402 response to Actor execution endpoints#2412
tobice wants to merge 2 commits intomasterfrom
docs/add-402-actor-execution-endpoints

Conversation

@tobice
Copy link
Copy Markdown
Contributor

@tobice tobice commented Apr 9, 2026

Updates API schema to match changes from apify/apify-core#26917: unauthenticated Actor execution requests now return 402 with X402 payment info instead of 401.

I have also updated the PamentRequired example to be more realistic.

Actor execution endpoints now return 402 Payment Required with X402
payment info when a request has no auth token and no payment headers.
See apify/apify-core#26917.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions github-actions bot added the t-core-services Issues with this label are in the ownership of the core services team. label Apr 9, 2026
@apify-service-account
Copy link
Copy Markdown

Preview for this PR was built for commit 86f43429 and is ready at https://pr-2412.preview.docs.apify.com!

@tobice tobice requested review from mvolfik and stepskop and removed request for fnesveda and janbuchar April 9, 2026 11:47
@tobice tobice added the adhoc Ad-hoc unplanned task added during the sprint. label Apr 9, 2026
@tobice tobice changed the title docs(openapi): Add 402 response to Actor sync execution endpoints docs(openapi): add 402 response to Actor execution endpoints Apr 9, 2026
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@tobice
Copy link
Copy Markdown
Contributor Author

tobice commented Apr 9, 2026

The POST <...>/runs execution endpoint has been already updated by @Pijukatel 😄 🏃 #2390

@apify-service-account
Copy link
Copy Markdown

Preview for this PR was built for commit eaac11f5 and is ready at https://pr-2412.preview.docs.apify.com!

@apify-service-account
Copy link
Copy Markdown

A PR to update the Python client models has been created: apify/apify-client-python#711

This was automatically triggered by OpenAPI specification changes in this PR.

content:
application/json:
schema:
$ref: ../schemas/common/ErrorResponse.yaml
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

You should use allOf here to make sure that type is set to the one true allowed value

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

It's following the same pattern as all other responses 🤔 Should it be changed everywhere? If so, then I'd do it in a separate PR.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Well, in https://github.com/apify/apify-docs/blob/3b28c7aeebbb3f77c51a6a89f7fc017e7a689eac/apify-api/openapi/components/schemas/common/errors/ActorErrors.yaml, it is correct already... I thought that PR changed every error response. @vdusek can you share you opinion please?

@tobice tobice requested a review from janbuchar April 9, 2026 14:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint. t-core-services Issues with this label are in the ownership of the core services team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants