Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update camunda REST API doc #4427

Merged
merged 2 commits into from
Oct 10, 2024
Merged

Update camunda REST API doc #4427

merged 2 commits into from
Oct 10, 2024

Conversation

github-actions[bot]
Copy link
Contributor

@github-actions github-actions bot commented Oct 8, 2024

Description

This is an autogenerated PR by the sync api specs workflow.
This PR contains every changes made to the REST api specs in the monorepo in the last week.
This PR contains also all the generated OpenAPI files related to the changes.

When should this change go live?

  • There is no urgency with this change and can be released at any time.

PR Checklist

  • My changes are for the next minor and are in /docs directory (aka /next/).
  • My changes require a technical writer review, and I've assigned @camunda/tech-writers as a reviewer.

@github-actions github-actions bot added the deploy Stand up a temporary docs site with this PR label Oct 8, 2024
@pepopowitz pepopowitz added deploy Stand up a temporary docs site with this PR and removed deploy Stand up a temporary docs site with this PR labels Oct 9, 2024
Copy link
Collaborator

@pepopowitz pepopowitz left a comment

Choose a reason for hiding this comment

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

Considering the large amount of changes here, not very many for me to carry upstream 💪

get:
tags:
- User task
summary: Return user task by a user task key.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
summary: Return user task by a user task key.
summary: Return user task by a user task key

❌ no periods in summary
owner: me in an upstream PR

@@ -441,6 +441,58 @@ paths:
schema:
$ref: "#/components/schemas/ProblemDetail"
/user-tasks/{userTaskKey}:
get:
tags:
- User task
Copy link
Collaborator

Choose a reason for hiding this comment

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

Not sure which one, but either this one or the next endpoint are going to need to change, for consistency. (The next one is tagged with User Task, in title case.)

owner: me

$ref: "#/components/schemas/FlowNodeInstanceItem"
"400":
description: >
The flow node instance Get failed.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The flow node instance Get failed.
The flow node instance request failed.

owner: me

$ref: "#/components/schemas/DecisionDefinitionItem"
"400":
description: >
The decision definition Get by key failed.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The decision definition Get by key failed.
The decision definition request failed.

owner: me

$ref: "#/components/schemas/DecisionRequirementsItem"
"400":
description: >
The decision requirements Get failed.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The decision requirements Get failed.
The decision requirements request failed.

owner: me

get:
tags:
- Decision requirements
summary: Get decision requirements XML (alpha).
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
summary: Get decision requirements XML (alpha).
summary: Get decision requirements XML (alpha)

owner: me

type: string
"400":
description: >
The decision requirements Get XML failed.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The decision requirements Get XML failed.
The decision requirements request failed.

owner: me

The decision instance search successful response.
"202":
description: |
The Authorization was patched successfully.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The Authorization was patched successfully.
The authorization was patched successfully.

owner: me

The Authorization was patched successfully.
"400":
description: |
The Authorization could not be patched.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The Authorization could not be patched.
The authorization could not be patched.

owner: me

format: date-time
endDate:
processDefinitionId:
description: Process defintion id of this process definition.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
description: Process defintion id of this process definition.
description: Process definition id of this process definition.

owner: me

@github-actions github-actions bot temporarily deployed to camunda-docs October 9, 2024 22:00 Destroyed
@tmetzke
Copy link
Member

tmetzke commented Oct 10, 2024

@pepopowitz, would you like to add the changes here and create an upstream PR to "manifest" them? Or just create the upstream PR and update here after merging it?

@pepopowitz
Copy link
Collaborator

@pepopowitz, would you like to add the changes here and create an upstream PR to "manifest" them? Or just create the upstream PR and update here after merging it?

I will merge this one as-is, and then open a PR upstream, so that the next sync corrects them all. I don't mind these things sitting in vNext for a week.

Copy link
Contributor Author

👋 🤖 🤔 Hello! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.6/.

  • docs/apis-tools/camunda-api-rest/specifications/activate-jobs.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/assign-user-task.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/broadcast-signal.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/cancel-process-instance.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/complete-job.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/complete-user-task.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/correlate-a-message.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/create-document-link-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/create-process-instance.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/create-user.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/delete-document-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/delete-resource.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/deploy-resources.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/download-document-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/evaluate-decision.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/fail-job.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/find-all-users.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-cluster-topology.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-decision-definition-by-key-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-decision-definition-xml-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-decision-instance-by-key-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-decision-requirements-by-key-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-decision-requirements-xml-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-flow-node-instance-by-key-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-incident-by-key-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-process-instance-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/get-status-of-camunda-license.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/migrate-process-instance.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/modify-process-instance.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/patch-authorization.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/pin-internal-clock-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/publish-a-message.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/query-decision-definitions-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/query-decision-instances-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/query-decision-requirements-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/query-flow-node-instances-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/query-incidents-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/query-process-instances-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/query-user-tasks-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/report-error-for-job.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/reset-internal-clock-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/resolve-incident.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/return-user-task-by-a-user-task-key.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/return-user-task-form.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/search-process-definitions-alpha.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/sidebar.js
  • docs/apis-tools/camunda-api-rest/specifications/unassign-user-task.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/update-a-job.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/update-element-instance-variables.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/update-user-task.api.mdx
  • docs/apis-tools/camunda-api-rest/specifications/upload-document-alpha.api.mdx

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

@pepopowitz pepopowitz enabled auto-merge (squash) October 10, 2024 14:24
@github-actions github-actions bot temporarily deployed to camunda-docs October 10, 2024 14:42 Destroyed
@pepopowitz pepopowitz merged commit cb62d74 into main Oct 10, 2024
7 checks passed
@pepopowitz pepopowitz deleted the update-rest-doc branch October 10, 2024 14:43
@pepopowitz pepopowitz removed the deploy Stand up a temporary docs site with this PR label Oct 10, 2024
Copy link
Contributor Author

🧹 Preview environment for this PR has been torn down.

github-merge-queue bot pushed a commit to camunda/camunda that referenced this pull request Oct 16, 2024
…cs (#23595)

## Description

This PR addresses a few small C8 REST API spec issues, most of which
were identified in camunda/camunda-docs#4427.
There are a few extra changes that were identified from pattern-matching
the issues in 4427.

See camunda/camunda-docs#4427 for original
conversation on these changes.
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.

2 participants