Get Started

Theme switcher

REST API

REST (Representational State Transfer) APIs are widely used due to their simplicity and statelessness. Theneo supports REST APIs through various collection formats, ensuring compatibility and ease of integration.

Supported Collections for REST APIs

  • OpenAPI 3.0 and 3.1: These specifications enable the definition of a REST API, including endpoints, methods, responses, and more, providing a comprehensive and standardized approach to RESTful services. ⬇️ Download a sample file
  • Swagger 2: A predecessor to OpenAPI, Swagger 2 allows for detailed API definitions and includes tools for auto-generating documentation, client SDKs, and more. 💾 Download a sample file
  • Postman Collections: Widely used for API testing, Postman collections allow you to define requests, tests, and scripts for API endpoints.⬇️ Download a sample file
  • Insomnia Collections: Similar to Postman, Insomnia offers a platform for API design and testing, with an emphasis on simplicity and a clean interface. ⬇️ Download a sample file

On the right side, you can see what an example REST API looks like. and below you should see how we automatically render the request and response descriptions. While these are automatically rendered you can also turn them off → see article

Below and right API request examples and responses are all fake, just for demo purposes

Header Parameters

Authorizationstring

Body Parameters

adventureTitlestring Required

The title of this week's epic saga. Make it sound like it's the next blockbuster movie or a top-selling fantasy novel

weekNumbernumber Required

Which chapter are we in our annual adventure? Week 1 is just 'Once Upon a Time,' but by Week 52, you're at 'Happily Ever After

Minimum
1
Maximum
52
theneoHighlightsobject

Show child attributes

teamHeroesarray

Show child attributes

treasureUnearthedstring Required

What grand discovery or idea did the team unearth this week? 'Ancient Algorithm of Awesome' or 'Cache of Cutting-Edge Concepts'?

dragonEncounteredboolean

True or false: Did the team face any metaphorical dragons this week? Budget cuts, server outages, or coffee shortages?

nextEpicChapterDatestring

When does the next adventure begin? Date of the upcoming sprint, meeting, or milestone

teamMoralenumber

Rate the team's spirit on a scale of 1 (a lone goblin) to 5 (a triumphant army of code warriors)

Response

200
Object

Response Attributes

statusCodenumber

Confirm the success of the request with a concise message.

statusMessagestring
summaryobject

Provides a brief overview of the week's adventure, including:

Show child attributes

400
Object

Response Attributes

statusCodenumber
statusMessagestring
errorDetailstring
401
Object
Unauthorized
403
Object
Forbidden
404
Object
Not Found

Response Attributes

statusCodenumber
statusMessagestring
errorDetailstring
Was this section helpful?

What made this section unhelpful for you?

POST

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?