Rebar Data API Documentation

Create a new user account

Request Body:

{
  "username": "string (min 3 chars)",
  "password": "string (min 6 chars)",
  "email": "string (optional)",
  "name": "string (optional)"
}

Example Usage:

curl -X POST  http://localhost:3001/auth/signup -H "Content-Type: application/json" -d '{"username":"string (min 3 chars)","password":"string (min 6 chars)","email":"string (optional)","name":"string (optional)"}'

Sign in to an existing account

Request Body:

{
  "username": "string",
  "password": "string"
}

Example Usage:

curl -X POST  http://localhost:3001/auth/signin -H "Content-Type: application/json" -d '{"username":"string","password":"string"}'

Create a new query. Queries are private by default.

Request Body:

{
  "content": "string",
  "name": "string",
  "description": "string (optional)",
  "isPublic": "boolean (optional, defaults to false)"
}

Example Usage:

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/create -H "Content-Type: application/json" -d '{"content":"string","name":"string","description":"string (optional)","isPublic":"boolean (optional, defaults to false)"}'

Get all public queries, ordered by creation date (newest first)

Example Usage:

curl   http://localhost:3001/queries/public

Get a specific query. Only accessible if query is public, you own it, or have explicit access.

Parameters:

Example Usage:

curl  -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId

Update an existing query that you own

Parameters:

Request Body:

{
  "content": "string (optional)",
  "name": "string (optional)",
  "description": "string (optional)",
  "isPublic": "boolean (optional)"
}

Example Usage:

curl -X PATCH -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId -H "Content-Type: application/json" -d '{"content":"string (optional)","name":"string (optional)","description":"string (optional)","isPublic":"boolean (optional)"}'

Delete a query that you own. This will also remove all saved instances and access controls.

Parameters:

Example Usage:

curl -X DELETE -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId

Get all queries created by the authenticated user

Example Usage:

curl  -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/created-queries

Create a copy of a query. Only works for queries you own, have access to, or are public. Cloned queries are private by default.

Parameters:

Example Usage:

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId/clone

Save a public query to your collection. Cannot save private queries.

Parameters:

Example Usage:

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId/save

Get all public queries saved by the authenticated user. Private queries are automatically removed from saved queries.

Example Usage:

curl  -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/saved-queries

Get all public queries saved by a specific user

Parameters:

Example Usage:

curl   http://localhost:3001/queries/user/:userId/saved-queries

Get the number of times a query has been saved

Parameters:

Example Usage:

curl   http://localhost:3001/queries/:queryId/save-count

Grant access to a specific user for your query

Parameters:

Example Usage:

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId/access/:userId

Revoke access from a specific user for your query

Parameters:

Example Usage:

curl -X DELETE -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId/access/:userId

Get a list of users who have access to your query

Parameters:

Example Usage:

curl  -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/:queryId/access

Get queries created by a specific user. Returns only public queries and ones you have access to.

Parameters:

Example Usage:

curl  -H "Authorization: Bearer YOUR_JWT_TOKEN" http://localhost:3001/queries/user/:userId/queries