Usage - Increment Agent Queries - Laburen Documentacion

curl --location --request POST 'https://dashboard.laburen.com/api/usage/increment-agent-queries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data-raw '{
    "provider": "azure-oss",
    "modelName": "gpt-5.6-sol",
    "inputTokens": 1500,
    "outputTokens": 500,
    "feature": "agent_run",
    "agentId": "clxxxxxxxxxxxxxxxxx"
}'

const apiUrl = 'https://dashboard.laburen.com/api';
const apiKey = '<API_KEY>';

const response = await fetch(`${apiUrl}/usage/increment-agent-queries`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${apiKey}`,
  },
  body: JSON.stringify({
    provider: 'azure-oss',
    modelName: 'gpt-5.6-sol',
    inputTokens: 1500,
    outputTokens: 500,
    feature: 'agent_run',
    agentId: 'clxxxxxxxxxxxxxxxxx',
  }),
});

const data = await response.json();
console.log(data);

import requests

api_url = "https://dashboard.laburen.com/api"
api_key = "<API_KEY>"

response = requests.post(
    f"{api_url}/usage/increment-agent-queries",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {api_key}",
    },
    json={
        "provider": "azure-oss",
        "modelName": "gpt-5.6-sol",
        "inputTokens": 1500,
        "outputTokens": 500,
        "feature": "agent_run",
        "agentId": "clxxxxxxxxxxxxxxxxx",
    },
)

data = response.json()
print(data)

{
  "success": true,
  "organizationId": "org_xxxxxxxxxxxx",
  "eventId": "evt_xxxxxxxxxxxx",
  "credits": {
    "charged": 0.045,
    "requested": 0.045
  },
  "model": {
    "provider": "azure-oss",
    "modelName": "gpt-5.6-sol"
  },
  "tokens": {
    "inputTokens": 1500,
    "outputTokens": 500
  }
}

POST

api

usage

increment-agent-queries

curl --location --request POST 'https://dashboard.laburen.com/api/usage/increment-agent-queries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data-raw '{
    "provider": "azure-oss",
    "modelName": "gpt-5.6-sol",
    "inputTokens": 1500,
    "outputTokens": 500,
    "feature": "agent_run",
    "agentId": "clxxxxxxxxxxxxxxxxx"
}'

const apiUrl = 'https://dashboard.laburen.com/api';
const apiKey = '<API_KEY>';

const response = await fetch(`${apiUrl}/usage/increment-agent-queries`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${apiKey}`,
  },
  body: JSON.stringify({
    provider: 'azure-oss',
    modelName: 'gpt-5.6-sol',
    inputTokens: 1500,
    outputTokens: 500,
    feature: 'agent_run',
    agentId: 'clxxxxxxxxxxxxxxxxx',
  }),
});

const data = await response.json();
console.log(data);

import requests

api_url = "https://dashboard.laburen.com/api"
api_key = "<API_KEY>"

response = requests.post(
    f"{api_url}/usage/increment-agent-queries",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {api_key}",
    },
    json={
        "provider": "azure-oss",
        "modelName": "gpt-5.6-sol",
        "inputTokens": 1500,
        "outputTokens": 500,
        "feature": "agent_run",
        "agentId": "clxxxxxxxxxxxxxxxxx",
    },
)

data = response.json()
print(data)

{
  "success": true,
  "organizationId": "org_xxxxxxxxxxxx",
  "eventId": "evt_xxxxxxxxxxxx",
  "credits": {
    "charged": 0.045,
    "requested": 0.045
  },
  "model": {
    "provider": "azure-oss",
    "modelName": "gpt-5.6-sol"
  },
  "tokens": {
    "inputTokens": 1500,
    "outputTokens": 500
  }
}

This endpoint is used to register credit consumption based on AI model usage. It tracks token usage (input/output) and automatically calculates the credit cost based on the model provider and configuration. Use Cases:

Track AI agent interactions and their associated costs
Bill custom integrations that use AI models
Monitor and control credit spending per agent or feature
Implement usage-based billing for your organization

This endpoint requires a valid subscription or sufficient credit balance. The request will fail if the organization has exceeded its usage limits.

Body

string

required

The AI model provider. Accepted values:

azure
azure-2
azure-oss
openai-responses
gemini
deepseek
openrouter
bedrock (deprecated)

string

required

The specific model name used for the request. The provider + modelName pair must match this table exactly — otherwise the event is recorded with 0 credits charged. Available models per provider:

Provider	Available Models
`azure`	`gpt-4o-mini`, `gpt-4o`
`azure-2`	`gpt-4.1-nano`, `gpt-4.1-mini`, `gpt-4.1`, `gpt-5-nano`, `gpt-5-mini`, `gpt-5-chat`, `gpt-5`
`azure-oss`	`gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-5.5`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `DeepSeek-V4-Pro`, `DeepSeek-V4-Flash`, `DeepSeek-V3.2`
`openai-responses`	`gpt-4.1`, `gpt-4.1-mini`
`gemini`	`gemini-2.0-flash`, `gemini-2.0-flash-exp`, `gemini-2.5-flash`, `gemini-2.5-pro`, `gemini-3-pro`, `gemini-3.1-pro`, `gemini-3-flash`
`deepseek`	`DeepSeek-V3.2-thinking`
`openrouter`	`glm-5.2`
`bedrock` (deprecated)	`claude-4-sonnet`, `claude-sonnet-4-6`, `claude-opus-4-6`, `claude-opus-4-7`

integer

default:"0"

The number of input tokens consumed in the request. Must be a non-negative integer.

integer

default:"0"

The number of output tokens generated in the response. Must be a non-negative integer.

integer

Optional multiplier for credit calculation (between 1 and 10). Useful for premium features or custom pricing tiers.

string

default:"agent_run"

The feature or action that triggered this credit spend (e.g., agent_run, chat_completion, embedding).

string

Optional. The ID of the agent associated with this usage. Useful for per-agent analytics and billing.

object

Optional. Additional metadata to associate with this credit event. Can include any custom fields for tracking purposes.

Response

boolean

Indicates whether the credit spend was successfully recorded.

string

The ID of the organization that was charged.

string

A unique identifier for this credit spend event. Useful for auditing and reconciliation.

object

Hide Toggle object

number

The actual number of credits charged for this event.

number

The number of credits that were requested based on the token count.

object

Hide Toggle object

string

The AI provider used.

string

The model name used.

object

Hide Toggle object

integer

The input tokens recorded.

integer

The output tokens recorded.

curl --location --request POST 'https://dashboard.laburen.com/api/usage/increment-agent-queries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data-raw '{
    "provider": "azure-oss",
    "modelName": "gpt-5.6-sol",
    "inputTokens": 1500,
    "outputTokens": 500,
    "feature": "agent_run",
    "agentId": "clxxxxxxxxxxxxxxxxx"
}'

const apiUrl = 'https://dashboard.laburen.com/api';
const apiKey = '<API_KEY>';

const response = await fetch(`${apiUrl}/usage/increment-agent-queries`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${apiKey}`,
  },
  body: JSON.stringify({
    provider: 'azure-oss',
    modelName: 'gpt-5.6-sol',
    inputTokens: 1500,
    outputTokens: 500,
    feature: 'agent_run',
    agentId: 'clxxxxxxxxxxxxxxxxx',
  }),
});

const data = await response.json();
console.log(data);

import requests

api_url = "https://dashboard.laburen.com/api"
api_key = "<API_KEY>"

response = requests.post(
    f"{api_url}/usage/increment-agent-queries",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {api_key}",
    },
    json={
        "provider": "azure-oss",
        "modelName": "gpt-5.6-sol",
        "inputTokens": 1500,
        "outputTokens": 500,
        "feature": "agent_run",
        "agentId": "clxxxxxxxxxxxxxxxxx",
    },
)

data = response.json()
print(data)

{
  "success": true,
  "organizationId": "org_xxxxxxxxxxxx",
  "eventId": "evt_xxxxxxxxxxxx",
  "credits": {
    "charged": 0.045,
    "requested": 0.045
  },
  "model": {
    "provider": "azure-oss",
    "modelName": "gpt-5.6-sol"
  },
  "tokens": {
    "inputTokens": 1500,
    "outputTokens": 500
  }
}

laburen API

Endpoints

Usage - Increment Agent Queries

Body

Response

​Body

​Response

Body

Response