Skip to content

docs: document operation state behaviour (#54) - #58

Open
rkandoi wants to merge 1 commit into
camaraproject:mainfrom
rkandoi:docs/54-operation-state-behaviour
Open

docs: document operation state behaviour (#54)#58
rkandoi wants to merge 1 commit into
camaraproject:mainfrom
rkandoi:docs/54-operation-state-behaviour

Conversation

@rkandoi

@rkandoi rkandoi commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

What type of PR is this?

  • documentation

Which issue(s) this PR fixes:

Fixes #54

Special notes for reviewers:

The operation state model was underdocumented. Now added in API yaml and General Description the following:

  • Clarified 4xx errors and errors after ACCEPTED
  • clarified polling on GET /operations/{operationId};
  • stated COMPLETED operation are retrievable only for a provider-defined period, after which it returns 404.

I have left some of wording choice on sync / async errors deliberately loose for a next version.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document API operation state behaviour

1 participant