Skip to content

Conversation

@danpoletaev
Copy link
Contributor

Recently, we introduced two new endpoints that return the OpenAPI specification:

  • /acts/<actorId>/builds/<buildId>/openapi-specification
  • /actor-builds/<buildId>/openapi-specification

This PR updates the documentation to include these endpoints.

@TC-MO Let me, please, know if you think we should add any additional information 🙏

@danpoletaev danpoletaev added the adhoc Ad-hoc unplanned task added during the sprint. label Jan 21, 2025
@github-actions github-actions bot added this to the 107th sprint - Platform team milestone Jan 21, 2025
@github-actions github-actions bot added the t-core-services Issues with this label are in the ownership of the core services team. label Jan 21, 2025
Copy link
Member

@jirimoravcik jirimoravcik left a comment

Choose a reason for hiding this comment

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

Didn't we also add an endpoint for default build? Is it going to be added in another PR?

@danpoletaev
Copy link
Contributor Author

Didn't we also add an endpoint for default build? Is it going to be added in another PR?

I'll add it in another PR

@danpoletaev danpoletaev requested a review from B4nan January 22, 2025 09:58
Copy link
Contributor

@TC-MO TC-MO left a comment

Choose a reason for hiding this comment

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

I've rewritten the descriptions slightly to address few things

  • Actor capitalization
  • Consistency
  • Small descriptions to give more context instead just giving the note about similar endpoints

@danpoletaev danpoletaev requested review from B4nan and TC-MO and removed request for B4nan January 22, 2025 14:00
Copy link
Member

@B4nan B4nan left a comment

Choose a reason for hiding this comment

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

just one nit

example: Your Magic Actor
version:
type: string
example: "1.0"
Copy link
Member

Choose a reason for hiding this comment

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

the quoting is inconsistent here, lets use single quotes everywhere (there are more places using double quotes, not just in this file)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hm, fixed in the files I've changed, but it is harder to change everywhere else. I think it should be fixed in lint, but we'll need to set up yaml lint for that...

@danpoletaev danpoletaev merged commit 8c7e259 into master Jan 22, 2025
7 checks passed
@danpoletaev danpoletaev deleted the feat/added-openapi-endpoints branch January 22, 2025 14:45
@fnesveda fnesveda added the validated Issues that are resolved and their solutions fulfill the acceptance criteria. label Jan 26, 2025
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. validated Issues that are resolved and their solutions fulfill the acceptance criteria.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants