---
title: "Identifiers, states, and limits"
description: "Stable identifier formats, pagination rules, retention windows, and request bounds."
---

> Documentation Index
> Fetch the complete documentation index at: https://help.tooluse.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Identifiers, states, and limits

<h2 id="identifier-formats">Identifier formats</h2>
<table>
<thead>
<tr>
<th>Object</th>
<th>Format</th>
</tr>
</thead>
<tbody>
<tr>
<td>Application</td>
<td><code>app_</code> + 32 lowercase hexadecimal characters</td>
</tr>
<tr>
<td>Purchase</td>
<td><code>pur_</code> + 32 lowercase hexadecimal characters</td>
</tr>
<tr>
<td>Handoff</td>
<td><code>hnd_</code> + 32 lowercase hexadecimal characters</td>
</tr>
<tr>
<td>Action job</td>
<td><code>actjob_</code> + 32 lowercase hexadecimal characters</td>
</tr>
<tr>
<td>Personal access token secret</td>
<td><code>amqp_</code> + opaque URL-safe secret</td>
</tr>
<tr>
<td>Agent key secret</td>
<td><code>amq_</code> + opaque URL-safe secret</td>
</tr>
<tr>
<td>Invitation secret</td>
<td><code>ami_</code> + opaque URL-safe secret</td>
</tr>
<tr>
<td>Checkout digest</td>
<td>64 lowercase hexadecimal characters</td>
</tr>
</tbody>
</table>
<p>Never parse an opaque identifier for business meaning.</p>
<h2 id="credential-lifetime">Credential lifetime</h2>
<table>
<thead>
<tr>
<th>Credential</th>
<th>Minimum</th>
<th>Maximum</th>
</tr>
</thead>
<tbody>
<tr>
<td>Personal access token</td>
<td>1 day</td>
<td>365 days</td>
</tr>
<tr>
<td>Agent key</td>
<td>1 day</td>
<td>90 days</td>
</tr>
</tbody>
</table>
<h2 id="pagination">Pagination</h2>
<p>Paged list routes use <code>page</code> starting at <code>1</code> and <code>size</code> from <code>1</code> through <code>100</code>. The usual default size is <code>25</code>.</p>
<h2 id="input-and-retention-limits">Input and retention limits</h2>
<table>
<thead>
<tr>
<th>Surface</th>
<th>Limit</th>
</tr>
</thead>
<tbody>
<tr>
<td>Built-in text operation</td>
<td>16,384 characters</td>
</tr>
<tr>
<td>Operation input map</td>
<td>30 top-level entries</td>
</tr>
<tr>
<td>Workflow YAML</td>
<td>512,000 characters</td>
</tr>
<tr>
<td>Full encrypted service result</td>
<td>One hour</td>
</tr>
<tr>
<td>Identical read-call reuse</td>
<td>Five minutes when eligible</td>
</tr>
</tbody>
</table>
<p>Operation-specific limits live in the discovered <code>inputSchema</code> and the generated <a href="https://help.tooluse.net/openapi.yaml">OpenAPI document</a>.</p>
<h2 id="common-states">Common states</h2>
<p>Native and service invocations expose states such as accepted/running, <code>SUCCESS</code>, <code>FAILED</code>, and <code>UNKNOWN</code>. <code>UNKNOWN</code> is an explicit reconciliation state and must not be treated as a safe retry signal.</p>

Source: https://help.tooluse.net/reference/identifiers/index.mdx