> ## Documentation Index > Fetch the complete documentation index at: https://entendre.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Set realized gain or loss account > Updates the ledger account used for realized gains and losses. ## OpenAPI ````yaml openapi-public-preview.json PUT /v1/organization/purpose-accounts openapi: 3.1.0 info: title: Entendre API version: 1.0.0 description: Programmatic access to crypto-native accounting and treasury operations. servers: - url: https://api.entendre.finance description: Production API. security: - ApiKey: [] tags: - name: Cost Basis description: >- Read and configure the organization cost-basis method and lot-tracking scope. - name: Organization description: Read your organization profile and find members for agent assignments. - name: Transactions description: Find transactions, inspect their details and create manual records. - name: Sources description: >- Manage wallets, exchange accounts, bank accounts and other transaction sources. - name: Assets description: Inspect asset acquisitions, remaining quantities and cost basis. - name: Journals description: >- Create and post journal entries, correct eligible entries and sync posted journals to a connected general ledger. - name: Documents description: >- Upload documents, check processing status and link supporting evidence to transactions. - name: Legal Entities description: Manage the legal entities used in your accounting records. - name: Ledger Accounts description: Manage your chart of accounts and find accounts for journal entries. - name: Tags description: Create and manage tags to classify your records. - name: Accruals description: >- Create and post accruals, inspect their status and reverse eligible entries. - name: Cash Application description: Match deposits to invoices and manage the resulting cash applications. - name: Classification description: >- Classify transactions in a batch, post eligible entries and inspect the results. - name: Revaluation description: Run asset revaluations for an accounting period and check their results. - name: Accounting Periods description: Check whether a period is ready to close, then close or reopen it. - name: Income Statement description: View revenue, expenses and net income for a reporting period. - name: Balance Sheet description: View assets, liabilities and equity as of a reporting date. - name: Trial Balance description: Review ledger account balances and debit and credit totals. - name: Closing Positions description: View asset positions at the end of a reporting period. - name: Treasury Balances description: Review treasury balances by asset and source. - name: Realized Gains & Losses description: Review realized gains and losses from asset dispositions. - name: Asset Tax Lots description: Inspect asset tax lots, remaining quantities and cost basis. - name: Schedule of Dispositions description: >- Review asset dispositions and their proceeds, cost basis and gains or losses. - name: Financial Insights description: Review financial insights for your selected reporting context. - name: Agents description: Create agents, schedule their work and inspect their runs. - name: Memory description: Read, search and maintain the memory files your agents use. - name: Connections description: Connect providers, manage authorization and disconnect. - name: GL Mapping description: >- Map ledger accounts and legal entities to your ERP. Import legal entities, tags and chart of accounts. - name: Request description: Request information, documents or connections from a client. - name: Client description: Manage your firm’s client relationships. - name: Team description: Invite team members and manage their access to your firm. - name: Settings description: Read and update your firm settings. - name: Purpose Accounts description: >- Read accounting purpose assignments and set the realized gain or loss account. externalDocs: description: Versioning, deprecation, and rate-limit policy url: https://entendre.ai/docs/get-started/versioning paths: /v1/organization/purpose-accounts: put: tags: - Purpose Accounts summary: Set realized gain or loss account description: >- Updates the ledger account used for realized gains and losses. Only `REALIZED_GAIN_LOSS` is accepted. Requires `write:organizations` and a user-owned key. Replaces the current assignment. Existing journal entries stay unchanged. operationId: setOrganizationPurposeAccount parameters: - name: Idempotency-Key in: header schema: type: string minLength: 1 maxLength: 256 description: >- Opaque idempotency key; UUIDv4 is recommended. Same key + same body = cached original response. Same key + different body = 422 IDEMPOTENCY_KEY_REUSED. An unusable key (empty, or longer than 256 characters) is ignored and the request runs without replay protection, signalled by X-Idempotency-Applied: false. Keys are retained for 24 hours. Validation failures do not consume the key. Inspect X-Idempotency-Applied and X-Idempotency-Replay on the response. requestBody: required: true content: application/json: schema: type: object required: - purpose - ledger_account_id additionalProperties: false properties: purpose: type: string enum: - REALIZED_GAIN_LOSS ledger_account_id: type: string description: Prefixed `lac_` id of a ledger account in your organization. pattern: ^(lac_)?[a-fA-F0-9]{24}$ example: purpose: REALIZED_GAIN_LOSS ledger_account_id: lac_64f1a2b3c4d5e6f708192a3b responses: '200': description: Saved realized gain or loss account. content: application/json: schema: type: object required: - data properties: data: type: object required: - purpose - ledger_account_id properties: purpose: type: string ledger_account_id: type: string sequence_number: type: - integer - 'null' ledger_account_name: type: - string - 'null' example: data: purpose: REALIZED_GAIN_LOSS ledger_account_id: lac_64f1a2b3c4d5e6f708192a3b sequence_number: 4500 ledger_account_name: Realized gain or loss '400': description: >- The request is invalid. `error.fields` lists the fields to correct. Nothing was changed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: VALIDATION_ERROR message: Invalid path, query or request body. request_id: req_example '401': description: The API key is missing, invalid or expired. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UNAUTHORIZED message: Invalid or expired API Key request_id: req_example suggested_action: Send an API key in X-API-Key. documentation_url: https://entendre.ai/docs/get-started/authentication headers: WWW-Authenticate: $ref: '#/components/headers/WWW-Authenticate' '403': description: >- The connection lacks the required organization permission or organization access. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: FORBIDDEN message: Insufficient access to organization request_id: req_example '404': description: The resource does not exist, or your organization cannot access it. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: RESOURCE_NOT_FOUND message: Resource not found request_id: req_example '429': description: >- Too many requests. If the response has a `Retry-After` header, wait that many seconds before you retry. Otherwise, read `error.message`. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer minimum: 1 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: RATE_LIMITED message: Rate limit exceeded. Retry after 30s. request_id: req_example components: schemas: ErrorResponse: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: Machine-readable error code. message: type: string description: Technical description for developers. fields: type: object additionalProperties: type: string description: >- Present only on VALIDATION_ERROR. Maps failing field paths to reason strings. details: type: object additionalProperties: true description: >- Optional redacted diagnostic details. Request validation uses fields or field_errors. suggested_action: type: string description: A suggested next step. documentation_url: type: string format: uri description: Link to documentation about this error. request_id: type: string description: Unique request ID for support escalation. description: Error details. headers: WWW-Authenticate: description: >- Bearer challenge with `realm="entendre"` and `resource_metadata`, the URL of the protected-resource metadata (RFC 9728). `error="invalid_token"` is added when the credential that was sent is invalid or expired. schema: type: string securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key description: >- Your organization API key. See [Authentication](/get-started/authentication). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.