---
title: "Apps"
description: "Create, inspect, and update Inttegro accounts."
canonical: "https://studio.inttegro.com/api/apps"
format: inttegro-machine-docs/v1
language: "Go"
sdk_version: "v11.0.1"
reader_profile: optional
reader_manifest: "https://studio.inttegro.com/machine/go/readers/index.json"
reader_identification: "Optional: declare your client only if known and your current-session capabilities; use reader_manifest for supplemental recommendations."
preamble_estimated_tokens: 497
model_token_report: "https://studio.inttegro.com/machine/token-report.json"
preamble_questions: 5
preamble_source: "machine-only-decisions"
recommended_mcp_tools: []
estimated_tokens: 6243
token_estimate_method: "utf8_bytes_divided_by_4"
---

## Machine preamble

**Summary:** Create, inspect, and update Inttegro accounts. This Go representation uses the selected SDK's native names wherever Studio has a verified mapping.

### Five questions

#### Q1. Is Apps the right source for this task?

Use this reference for create, inspect, and update inttegro accounts. Keep the four decision rules below with its exact operations and fields; do not infer a broader workflow from endpoint order.

#### Q2. What does “Create an app only for a durable operating boundary” require?

**Create an app only for a durable operating boundary.** A business, seller,
tenant, sales channel, or environment can warrant an app; a shopper, order,
device, or checkout session does not. If the request is about a buyer, start
with [Customers](https://studio.inttegro.com/machine/go/api/customers.md) instead.

#### Q3. What does “Capture credentials during creation” require?

**Capture credentials during creation.** After [Create an app](#create-an-app),
persist [`App.SecretKey.Token`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)before continuing. Lookup and update cannot recover that token. Use [API
keys](https://studio.inttegro.com/machine/go/api/keys.md) for subsequent credential lifecycle work.

#### Q4. What does “Verify isolation before composing a workflow” require?

**Verify isolation before composing a workflow.** The key used by the caller
selects the app boundary for its orders, customers, payment methods,
balances, payouts, files, and messages. Do not assume an identifier obtained
under another app is usable here.

#### Q5. What does “Ordinary creation needs no placement override” require?

**Ordinary creation needs no placement override.** Omit [`PlacementParentApplicationID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.PlacementParentApplicationID)unless the workflow already has separately authorized delegated placement
details.

## Document content

# Apps

An app is an Inttegro account. It represents the business, seller, sales channel, tenant, or environment that is selling, collecting payments, messaging customers, and receiving payouts through Inttegro.

Everything that happens for that account belongs to its app: orders, customers, payment methods, balances, payouts, files, and customer messages. This keeps each business unit or tenant in its own operating boundary, so records, reconciliation, and access do not bleed across accounts.

Apps also have secret keys. When your backend uses a key, it is acting for that app. Use the Apps API when you need to create or manage Inttegro accounts programmatically: onboarding a merchant or tenant, separating production from staging, isolating a sales channel, or giving a child integration its own credentials. Do not create apps for individual shoppers, orders, devices, or checkout sessions.

## Choose and verify the app boundary

The four decision rules are in the machine preamble above.

## The app object

An app object contains the stable identifier and human-readable metadata for one Inttegro account. Secret key values are not returned on normal app lookups; the initial token appears only in the response from [Create an app](#create-an-app).

### Properties

- [`Alias`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Optional short label for the app. Use this for names that are easier to
  scan in dashboards, logs, or developer tooling than the generated app ID.

- [`ArchivedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app was archived. Omitted while the app is active.

- [`Capabilities`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `object`

  Public capability states currently available to this app. New capability
  keys can appear as more Inttegro products become available.

- [`CreatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app was created.

- [`Description`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Optional longer description of what the app is used for.

- [`ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Unique identifier for the app. App IDs begin with the
  `app_`
  prefix.

- [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Display name for the app.

- [`Relationship`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)

  Direct placement for this app. Omitted for root apps.

  - [`Relationship.CreatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

    When the relationship was created.

  - [`Relationship.ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Unique identifier for the relationship.

  - [`Relationship.Kind`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Relationship kind.

  - [`Relationship.Parent`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `object`

    The app that directly contains this app, including its ID, current name, and optional alias.

  - [`Relationship.Status`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Current relationship status.

- [`UpdatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app metadata was last updated. Omitted until the first update.

## Create an app

Create an Inttegro child app and its first secret key. Your current Inttegro account becomes its parent unless you supply separately authorized delegated placement details.

Store [`App.SecretKey.Token`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) immediately after the
response is received. The full token is returned only at creation time
and is not included in later lookup or update responses.

Surrounding whitespace is removed from text attributes, and unknown
attributes are rejected. [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.Name) must remain non-empty
after trimming. For [`LegalEntityType`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.LegalEntityType), use
`"government"`,
`"non_profit"`,
`"business"`, or
`"individual"`; integrations
should not rely on undocumented classifications being accepted.

Omit [`PlacementParentApplicationID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.PlacementParentApplicationID) for ordinary
child-app creation. Placing the child under another app requires a valid
authorization receipt for that relationship and a compatible
[`RelationshipPolicy`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.RelationshipPolicy); a parent ID alone is not
sufficient.

### Request attributes

- [`Alias`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.Alias) — `string`

  Optional short label for the app. The API trims surrounding whitespace
  before storing it.

- [`Description`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.Description) — `string`

  Optional description of what the app is used for.

- [`LegalEntityType`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.LegalEntityType) — `string`

  Optional legal-entity classification. The API trims surrounding
  whitespace and stores the supplied string.

- [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.Name) — `string` — required

  Display name for the app. Must not be empty after trimming whitespace.

- [`PlacementParentApplicationID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.PlacementParentApplicationID) — `string`

  App under which to place the new child app. Omit this to use the app
  that authenticates the request. A different parent requires separately
  authorized delegated placement details.

- [`RelationshipPolicy`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CreateParams.RelationshipPolicy) — `*app.RelationshipPolicy`

  Optional policy for the parent-child app relationship. Omitted fields use the defaults shown below.

  - [`RelationshipPolicy.ChildStanding`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#RelationshipPolicy.ChildStanding) — `string`

    Standing of the child app. Supported values are `"controlled"`, `"temporary_setup"`, and `"independent"`. Defaults to `"controlled"` for parent-managed apps and `"independent"` for child-managed apps.

  - [`RelationshipPolicy.Credentials`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#RelationshipPolicy.Credentials) — `app.CredentialOwner`

    Which app controls credentials. Supported values are [`app.CredentialOwnerChild`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CredentialOwnerChild) and [`app.CredentialOwnerParent`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CredentialOwnerParent). Defaults to [`app.CredentialOwnerChild`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#CredentialOwnerChild).

  - [`RelationshipPolicy.Management`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#RelationshipPolicy.Management) — `app.ManagementRole`

    Which app manages the relationship. Supported values are [`app.ManagementRoleParent`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#ManagementRoleParent) and [`app.ManagementRoleChild`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#ManagementRoleChild). Defaults to [`app.ManagementRoleParent`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#ManagementRoleParent).

### Response shape

The response contains the new `app.App`, its placement
relationship, and a create-only [`App.SecretKey`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App).

Optional app attributes are omitted when empty. Although
[`App.SecretKey`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) is expected for normal public creation,
clients must still check that it is present before attempting to store the
token.

## Interpret the relationship receipt

The relationship object identifies the new app's direct parent and current
placement state. It is a receipt, not an authorization policy: do not infer
credential control, delegated authority, or broader hierarchy from fields
that are not present. For ordinary creation, [`App.Relationship.Parent.ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)  identifies the app whose key authenticated the request. The child is the
app object that contains this relationship.

### Response attributes

- [`Alias`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Short label stored for the app.

- [`CreatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app was created.

- [`Capabilities`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `object`

  Capability states available immediately after creation. New apps can
  return an empty object until capabilities become available.

- [`Description`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Description stored for the app.

- [`ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Unique app ID with the `app_` prefix.

- [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Display name stored for the app.

- [`Relationship`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)

  Direct placement created for the new app.

  - [`Relationship.CreatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

    When the relationship was created.

  - [`Relationship.ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Unique identifier for the relationship.

  - [`Relationship.Kind`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Relationship kind.

  - [`Relationship.Parent`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `object`

    The app that directly contains the new app, including its ID, current name, and optional alias.

  - [`Relationship.Status`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Current relationship status.

- [`SecretKey`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)

  Initial secret key for the new app. Returned only by this endpoint.

  - [`SecretKey.ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Unique identifier for the secret key.

  - [`SecretKey.IssuedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

    When the secret key was issued.

  - [`SecretKey.Token`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Bearer token value. Store this value immediately; it is returned only once.

  - [`SecretKey.TokenType`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Token type. Currently `"bearer"`.

**Request — POST /apps/create**

```go
package main

import (
  "context"
  "log"
  "os"

  inttegro "github.com/inttegro/inttegro-sdk-go/v11"
  "github.com/inttegro/inttegro-sdk-go/v11/app"
)

func main() {
  ctx := context.Background()
  client := inttegro.NewClient(os.Getenv("INTTEGRO_API_KEY"))

  params := app.CreateParams{
    Alias: "acme-prod-api",
    Description: "Production Inttegro API for Acme Marketplace",
    LegalEntityType: "business",
    Name: "Acme Production API",
  }
  result, err := client.Apps.Create(ctx, params)
  if err != nil {
    log.Fatal(err)
  }
  _ = result
}
```

```json
{
  "app": {
    "alias": "acme-prod-api",
    "capabilities": {},
    "created_at": "2025-02-15T14:30:00Z",
    "description": "Production Inttegro API for Acme Marketplace",
    "id": "app_F2gH4iJ6kL8mN0oP2qR4sT6uV8wX0yZ",
    "name": "Acme Production API",
    "relationship": {
      "created_at": "2025-02-15T14:30:00Z",
      "id": "apprel_2xL4nP6rT8vX0zB2dF4hJ6lN8pR0tV2x",
      "kind": "placement",
      "parent": {
        "alias": "acme-platform",
        "id": "app_M8nP0qR2sT4uV6wX8yZ0aB2cD4eF6gH",
        "name": "Acme Platform"
      },
      "status": "active"
    },
    "secret_key": {
      "id": "sk_Q1wE3rT5yU7iO9pA2sD4fG6hJ8kL0zX",
      "issued_at": "2025-02-15T14:30:00Z",
      "token": "<SECRET_KEY_TOKEN>",
      "token_type": "bearer"
    }
  }
}
```

## Lookup an app

Retrieve the app associated with the API key used on the request. Use this endpoint to confirm which app a secret key authenticates as, or to display app metadata in your own tooling.

The request has no body. An empty JSON object is also accepted. Unknown attributes are rejected. The response includes app metadata and, for a child app, its direct placement relationship. It never includes secret key values.

### Request attributes

No request body is required.

### Response shape

The response returns `app.App` for your current account.
Child apps include [`App.Relationship`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App); root apps omit
it.

## Use the relationship as a placement receipt

When present, [`App.Relationship`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)  identifies the app's direct parent and current placement status. It does
not describe credential control, delegated authority, or the wider app
hierarchy. The relationship belongs to the returned app, and [`App.Relationship.Parent.ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)  identifies its direct parent.

### Response attributes

- [`Alias`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Short label stored for the app.

- [`ArchivedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app was archived. Omitted while the app is active.

- [`CreatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app was created.

- [`Capabilities`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `object`

  Public capability states currently available to the app. Read only the
  keys your integration understands and allow new keys to appear.

- [`Description`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Description stored for the app.

- [`ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Unique app ID with the `app_` prefix.

- [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Display name stored for the app.

- [`Relationship`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App)

  Direct placement for the authenticated app. Omitted for root apps.

  - [`Relationship.CreatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

    When the relationship was created.

  - [`Relationship.ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Unique identifier for the relationship.

  - [`Relationship.Kind`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Relationship kind.

  - [`Relationship.Parent`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `object`

    The app that directly contains this app, including its ID, current name, and optional alias.

  - [`Relationship.Status`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

    Current relationship status.

- [`UpdatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app metadata was last updated. Omitted until the first update.

**Request — POST /apps/lookup**

```go
package main

import (
  "context"
  "log"
  "os"

  inttegro "github.com/inttegro/inttegro-sdk-go/v11"
)

func main() {
  ctx := context.Background()
  client := inttegro.NewClient(os.Getenv("INTTEGRO_API_KEY"))

  result, err := client.Apps.Lookup(ctx)
  if err != nil {
    log.Fatal(err)
  }
  _ = result
}
```

```json
{
  "app": {
    "alias": "acme-prod-api",
    "capabilities": {
      "payments": {
        "status": "enabled",
        "status_changed_at": "2025-02-15T14:30:00Z"
      },
      "payouts": {
        "status": "enabled",
        "status_changed_at": "2025-02-15T14:30:00Z"
      }
    },
    "created_at": "2025-02-15T14:30:00Z",
    "description": "Production Inttegro API for Acme Marketplace",
    "id": "app_F2gH4iJ6kL8mN0oP2qR4sT6uV8wX0yZ",
    "name": "Acme Production API",
    "relationship": {
      "created_at": "2025-02-15T14:30:00Z",
      "id": "apprel_2xL4nP6rT8vX0zB2dF4hJ6lN8pR0tV2x",
      "kind": "placement",
      "parent": {
        "alias": "acme-platform",
        "id": "app_M8nP0qR2sT4uV6wX8yZ0aB2cD4eF6gH",
        "name": "Acme Platform"
      },
      "status": "active"
    },
    "updated_at": "2025-02-16T09:45:30Z"
  }
}
```

## Update an app

Update metadata for the app associated with the API key used on the request. This endpoint changes app labels and classification; it does not rotate secret keys or move resources between apps.

Send at least one mutable attribute. Unknown attributes are rejected. Text
values are trimmed; empty [`Alias`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.Alias),
[`Description`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.Description), and
[`LegalEntityType`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.LegalEntityType) values clear those fields, while an
empty [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.Name) is rejected.

Sending values that are already stored succeeds without changing
[`App.UpdatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App).

### Request attributes

- [`Alias`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.Alias) — `*string`

  New short label for the app. Send an empty string to clear it.

- [`Description`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.Description) — `*string`

  New app description. Send an empty string to clear it.

- [`LegalEntityType`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.LegalEntityType) — `*string`

  Legal-entity classification. The API trims surrounding whitespace and
  stores the supplied string.

- [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#UpdateParams.Name) — `*string`

  New display name for the app. Must not be empty after trimming
  whitespace.

### Response shape

The response returns `app.App` with the current metadata
after the update.

### Response attributes

- [`Alias`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Short label stored for the app.

- [`CreatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app was created.

- [`Description`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Description stored for the app.

- [`ID`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Unique app ID with the `app_` prefix.

- [`Name`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `string`

  Display name stored for the app.

- [`UpdatedAt`](https://pkg.go.dev/github.com/inttegro/inttegro-sdk-go/v11@v11.0.1/app#App) — `timestamp`

  When the app metadata was last updated.

**Request — POST /apps/update**

```go
package main

import (
  "context"
  "log"
  "os"

  inttegro "github.com/inttegro/inttegro-sdk-go/v11"
  "github.com/inttegro/inttegro-sdk-go/v11/app"
  "github.com/inttegro/inttegro-sdk-go/v11/request"
)

func main() {
  ctx := context.Background()
  client := inttegro.NewClient(os.Getenv("INTTEGRO_API_KEY"))

  params := app.UpdateParams{
    Alias: inttegro.String("acme-checkout-api"),
    Description: inttegro.String("Checkout API for Acme Marketplace"),
    LegalEntityType: inttegro.String("business"),
    Name: inttegro.String("Acme Checkout API"),
  }
  result, err := client.Apps.Update(ctx, params, request.WithIdempotencyKey("app-update-acme-checkout-001"))
  if err != nil {
    log.Fatal(err)
  }
  _ = result
}
```

```json
{
  "app": {
    "alias": "acme-checkout-api",
    "capabilities": {
      "payments": {
        "status": "enabled",
        "status_changed_at": "2025-02-15T14:30:00Z"
      },
      "payouts": {
        "status": "enabled",
        "status_changed_at": "2025-02-15T14:30:00Z"
      }
    },
    "created_at": "2025-02-15T14:30:00Z",
    "description": "Checkout API for Acme Marketplace",
    "id": "app_F2gH4iJ6kL8mN0oP2qR4sT6uV8wX0yZ",
    "name": "Acme Checkout API",
    "updated_at": "2025-02-16T09:45:30Z"
  }
}
```
