Skip to content

HTTP API: Schema endpoint #736

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

Open
wants to merge 10 commits into
base: main
Choose a base branch
from
Open

HTTP API: Schema endpoint #736

wants to merge 10 commits into from

Conversation

knakatasf
Copy link

@knakatasf knakatasf commented Jul 3, 2025

Description

Add a docs-hugo for new schema endpoints: /schema, /schema/graph/{graph-name}, /schema/view/{view-name}, /schema/collection/{collection-name}.
Includes query parameters (sampleNum, exampleNum) and examples of http requests and responses.

Upstream PRs

  • 3.10:
  • 3.11:
  • 3.12:
  • 3.13:

Copy link
Contributor

Deploy Preview Available Via
https://deploy-preview-736--docs-hugo.netlify.app

@cla-bot cla-bot bot added the cla-signed label Jul 3, 2025
@Simran-B Simran-B changed the title Http api schema endpoint HTTP API: Schema endpoint Jul 3, 2025
- Schema
```

**Examples**
Copy link
Contributor

Choose a reason for hiding this comment

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

Please see existing content how to use ```curl blocks for generated examples. You basically need to write an arangosh script that generates some minimal data and then use special functions for outputting request to be displayed in the docs.

Copy link
Author

@knakatasf knakatasf Jul 6, 2025

Choose a reason for hiding this comment

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

I added curl blocks for all 4 endpoints, but how can I verify the commands would be compiled correctly? And, should I add more examples? Or, are the examples too specific?

@Simran-B Simran-B added this to the 3.12.6 milestone Jul 8, 2025
nerpaula and others added 4 commits July 9, 2025 00:55
* reworked graphml documentation

* fix merge related errors

* Apply suggestions from code review

Co-authored-by: Simran <[email protected]>

* review

* minor changes

* review

---------

Co-authored-by: Simran <[email protected]>
#737)

* Fix API call recording OpenAPI description and release notes

* Apply to 3.13

* Upper-case requestType in responses
* Update for UI changes

* Add Canvas Actions

* Fix links

* fix typo

---------

Co-authored-by: Paula Mihu <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants