---
title: "renew_image_link"
description: "Generated reference for the management action renew_image_link: its description, access metadata, payload contract, and registration status."
slug: /reference/actions/renew-image-link
order: 92
visibility: public
redirects_from: []
---

# renew\_image\_link

Generated automatically from the [published contract sources](/cloud/reference/about/#contract-sources).

A script calls this action over HTTPS at `POST https://turnzero.ai/api/v1/renew_image_link`, with a bearer credential and the action's payload as the JSON body. An MCP connection lists this action as the tool `renew_image_link`.

OAuth access tokens and minted tokens, including the turnzero command's computer token, are bearer credentials. The action determines which kinds, scopes and grants it accepts ([Sign-in, sessions, and tokens](/cloud/concepts/sign-in-sessions-and-tokens/)).

**Build metadata:** Registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.

## Contract description

Renew your link to a picture `generate_image` saved without `application`\. Pass its `name`\. Each call ends the previous link and gives one valid for at most one hour, never past `kept_until`\. Anyone with `link` can open the picture in a browser without signing in\. The answer also gives two download commands\. On MCP, `inline: true` also returns the picture as image content if it is at most 256 KiB\. A larger or unreadable picture still has its link\. The picture is kept for 7 days\. After `kept_until`, the call refuses `image_expired` while the picture's record remains\. A name your account holds no picture of refuses `image_not_found`\. This call generates no picture and uses no image from your cap\.

## More about this action

Pass `name`, as `generate_image` gave it for a picture saved without `application`, and optionally `inline`\. This call replaces the picture's link and ends the one an earlier answer gave\. It extends no keep, generates no picture, calls no provider and consumes none of your image cap\.

`address` reaches the picture under your own sign\-in or an account\-wide token with no bounding grant\. `link` adds read\-only access for anyone holding it, with no sign\-in, until `expires_at`\. That instant is the earlier of one hour after this call and `kept_until`\. The two commands download through that link without an Authorization header\. Reads do not spend it\.

Only pictures saved without an application have links this call can renew\. The picture's `kept_until` is seven days after its original write\. A known picture past it refuses `image_expired`\. A name your account holds no picture of refuses `image_not_found`\. Download before the keep ends\.

With `inline: true`, an MCP answer also carries the picture if it is at most 256 KiB and its bytes can be read\. A larger picture, a call over HTTP, or an unreadable blob carries no image block\. `inline.reason` says why, and the link and commands remain\.

A signed\-in connection and an account\-wide token may call this tool\. An application's platform credential, a token restricted to one application, a token restricted by a grant, and a device sign\-in cannot\.

## Access and action metadata

```json
{
  "name": "renew_image_link",
  "resource": "account",
  "tier": "reversible",
  "surface": "account",
  "addresses": [
    "tzcloud",
    "tztools"
  ],
  "summary": "Renew your link to a picture `generate_image` saved without `application`. Pass its `name`. Each call ends the previous link and gives one valid for at most one hour, never past `kept_until`. Anyone with `link` can open the picture in a browser without signing in. The answer also gives two download commands. On MCP, `inline: true` also returns the picture as image content if it is at most 256 KiB. A larger or unreadable picture still has its link. The picture is kept for 7 days. After `kept_until`, the call refuses `image_expired` while the picture's record remains. A name your account holds no picture of refuses `image_not_found`. This call generates no picture and uses no image from your cap.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "openWorldHint": false
  }
}
```

## MCP catalog entry

```json
{
  "name": "renew_image_link",
  "title": "Renew an image link",
  "tier": "reversible",
  "scenario": "ACB-L0-93",
  "summary": "Renew your link to a picture `generate_image` saved without `application`. Pass its `name`. Each call ends the previous link and gives one valid for at most one hour, never past `kept_until`. Anyone with `link` can open the picture in a browser without signing in. The answer also gives two download commands. On MCP, `inline: true` also returns the picture as image content if it is at most 256 KiB. A larger or unreadable picture still has its link. The picture is kept for 7 days. After `kept_until`, the call refuses `image_expired` while the picture's record remains. A name your account holds no picture of refuses `image_not_found`. This call generates no picture and uses no image from your cap.",
  "owners": [
    "ACB-L0-93",
    "MCP-08",
    "API-L0-17",
    "SEC-L0-07"
  ]
}
```

## request

| JSON pointer | Description and constraints |
|---|---|
| "" \(root\) | Type: object<br>Required fields: \["name"\] |
| /<wbr>properties/<wbr>name | The name `generate_image` gave a picture saved without `application`\. A name your account holds no picture of refuses `image_not_found`\.<br><br>Type: string<br>Minimum length: 1 |
| /<wbr>properties/<wbr>inline | When true, also return MCP image content if the picture is at most 256 KiB and can be read\. A larger file, an HTTP call or a failed read includes no image block; the answer says why\.<br><br>Type: boolean |

## response

| JSON pointer | Description and constraints |
|---|---|
| "" \(root\) | Type: object<br>Required fields: \["contract\_version","name","mime\_type","bytes","kept\_until","address","link","expires\_at","commands","detail"\] |
| /<wbr>properties/<wbr>contract\_version | Required value: 1 |
| /<wbr>properties/<wbr>reference | The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call’s record row\. Quote it when you report the call\.<br><br>Type: string<br>Pattern: ^\[0\-9a\-f\]\{10\}$ |
| /<wbr>properties/<wbr>name | The picture's name\.<br><br>Type: string |
| /<wbr>properties/<wbr>mime\_type | The picture's media type: image/png, image/jpeg or image/webp\.<br><br>Type: string |
| /<wbr>properties/<wbr>bytes | The picture's size in bytes\.<br><br>Type: integer |
| /<wbr>properties/<wbr>kept\_until | When the picture's original 7\-day keep ends, as an ISO 8601 instant\. This call does not extend it\.<br><br>Type: string |
| /<wbr>properties/<wbr>address | The picture's address\. Read it with your account's session credential or an account\-wide token with no bounding grant\.<br><br>Type: string |
| /<wbr>properties/<wbr>link | The address with read\-only access for anyone holding it, without sign\-in, until `expires_at`\. This link replaces the one an earlier answer gave\.<br><br>Type: string |
| /<wbr>properties/<wbr>expires\_at | When this link stops opening the picture, as an ISO 8601 instant: the earlier of one hour after this call and `kept_until`\.<br><br>Type: string |
| /<wbr>properties/<wbr>commands | Two commands that download through `link` without an Authorization header and write the picture under its name\.<br><br>Type: object<br>Required fields: \["curl","powershell"\]<br>Additional properties: false |
| /<wbr>properties/<wbr>commands/<wbr>properties/<wbr>curl | A curl command for a POSIX shell: it fetches the link and writes the picture under its name in the folder it runs in\.<br><br>Type: string |
| /<wbr>properties/<wbr>commands/<wbr>properties/<wbr>powershell | An Invoke\-WebRequest command for Windows PowerShell, with \-UseBasicParsing: the same link and the same file\.<br><br>Type: string |
| /<wbr>properties/<wbr>inline | Present where the call passed `inline` true\.<br><br>Type: object<br>Required fields: \["returned"\]<br>Additional properties: false |
| /<wbr>properties/<wbr>inline/<wbr>properties/<wbr>returned | Whether this answer carries the picture as image content\.<br><br>Type: boolean |
| /<wbr>properties/<wbr>inline/<wbr>properties/<wbr>reason | Why no image block was returned: the picture is larger than 256 KiB, the call came over HTTP, or its bytes could not be read\.<br><br>Type: string |
| /<wbr>properties/<wbr>detail | The new link's replacement of the old one, when the link and the keep end, and how to download the picture\.<br><br>Type: string |

## Complete payload contract

```json
{
  "request": {
    "type": "object",
    "required": [
      "name"
    ],
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "description": "The name `generate_image` gave a picture saved without `application`. A name your account holds no picture of refuses `image_not_found`."
      },
      "inline": {
        "type": "boolean",
        "description": "When true, also return MCP image content if the picture is at most 256 KiB and can be read. A larger file, an HTTP call or a failed read includes no image block; the answer says why."
      }
    }
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "name",
      "mime_type",
      "bytes",
      "kept_until",
      "address",
      "link",
      "expires_at",
      "commands",
      "detail"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call’s record row. Quote it when you report the call."
      },
      "name": {
        "type": "string",
        "description": "The picture's name."
      },
      "mime_type": {
        "type": "string",
        "description": "The picture's media type: image/png, image/jpeg or image/webp."
      },
      "bytes": {
        "type": "integer",
        "description": "The picture's size in bytes."
      },
      "kept_until": {
        "type": "string",
        "description": "When the picture's original 7-day keep ends, as an ISO 8601 instant. This call does not extend it."
      },
      "address": {
        "type": "string",
        "description": "The picture's address. Read it with your account's session credential or an account-wide token with no bounding grant."
      },
      "link": {
        "type": "string",
        "description": "The address with read-only access for anyone holding it, without sign-in, until `expires_at`. This link replaces the one an earlier answer gave."
      },
      "expires_at": {
        "type": "string",
        "description": "When this link stops opening the picture, as an ISO 8601 instant: the earlier of one hour after this call and `kept_until`."
      },
      "commands": {
        "type": "object",
        "required": [
          "curl",
          "powershell"
        ],
        "properties": {
          "curl": {
            "type": "string",
            "description": "A curl command for a POSIX shell: it fetches the link and writes the picture under its name in the folder it runs in."
          },
          "powershell": {
            "type": "string",
            "description": "An Invoke-WebRequest command for Windows PowerShell, with -UseBasicParsing: the same link and the same file."
          }
        },
        "additionalProperties": false,
        "description": "Two commands that download through `link` without an Authorization header and write the picture under its name."
      },
      "inline": {
        "type": "object",
        "required": [
          "returned"
        ],
        "properties": {
          "returned": {
            "type": "boolean",
            "description": "Whether this answer carries the picture as image content."
          },
          "reason": {
            "type": "string",
            "description": "Why no image block was returned: the picture is larger than 256 KiB, the call came over HTTP, or its bytes could not be read."
          }
        },
        "additionalProperties": false,
        "description": "Present where the call passed `inline` true."
      },
      "detail": {
        "type": "string",
        "description": "The new link's replacement of the old one, when the link and the keep end, and how to download the picture."
      }
    }
  }
}
```

## Shared contracts

- [Refusals](/cloud/reference/refusals/): every refusal, by surface, with its cause and its remedy
- [schemas/wire\_error\.schema\.json](/cloud/reference/sources/schemas/wire-error-schema/)
- [schemas/wire\_errors\.json](/cloud/reference/sources/schemas/wire-errors/)
- [schemas/action\_payloads\.json](/cloud/reference/sources/schemas/action-payloads/) (includes shared shapes)
- [management\_api\_contract\.md](/cloud/reference/sources/management-api-contract/)
