Rowlogy
Docs
Explore
Skip to Content
CTRL K
  • About Rowlogy
    • Using API Keys
    • Get Project Content
      • Decrement Value
      • Delete Value
      • Increment Value
      • Insert Value
      • Push Value
      • Set Project Content
    • Update Project Content
    • Java
    • JavaScript (Browser)
    • Python
    • TypeScript
  • About Rowlogy
    • Using API Keys
    • Get Project Content
      • Decrement Value
      • Delete Value
      • Increment Value
      • Insert Value
      • Push Value
      • Set Project Content
    • Update Project Content
    • Java
    • JavaScript (Browser)
    • Python
    • TypeScript

On This Page

  • Endpoint
  • Path Parameters
  • Request Body
  • Authentication
  • Session Token
  • API Key Authentication
  • Response
  • Success (200 OK)
  • Error Responses
API ContentOperationsInsert Value

This endpoint allows you to insert a value into an array at a specified path and index within a project’s content.

Endpoint

POST https://rowlogy.com/api/:username/:projectSlug/content/insert

Path Parameters

ParameterTypeDescription
usernamestringThe username of the project owner. Must start with ”@”.
projectSlugstringThe project ID of the project.

Request Body

The request body should be a JSON object with the following properties:

ParameterTypeDescription
pathstringThe dot-separated path to the array (e.g., data.items).
valueanyThe value to insert into the array.
indexnumberThe zero-based index at which to insert the value.
{ "path": "data.items", "value": { "id": 3, "name": "New Item" }, "index": 1 }

Authentication

You can authenticate your requests using one of the following methods:

Session Token

Include your session token in the Authorization header:

Authorization: Bearer <YOUR_SESSION_TOKEN>

API Key Authentication

Alternatively, you can authenticate using an API key. Include your API key in the Authorization header:

Authorization: Bearer <YOUR_API_KEY>

For more details on generating and managing API keys, see the Using API Keys guide.

Response

Success (200 OK)

{ "message": "Value inserted successfully" }

Error Responses

  • 400 Bad Request:
    • If path is missing or not a string.
    • If index is missing or not a number.
    • If the target path is not an array.
  • 401 Unauthorized:
    • If no authentication (user session or API key) is provided.
    • If the provided API key is invalid or expired.
  • 403 Forbidden:
    • If the authenticated user does not have access to the project.
    • If the API key used does not have the required permissions for this project.
  • 404 Not Found: If the project or user does not exist.
  • 500 Internal Server Error: For any server-side issues.
Last updated on December 31, 2025
Increment ValuePush Value

© 2026 Rowlogy

PrivacyTerms