# Indexing commands

Signatures, flags and examples for recala index.

## Use these commands

Check indexing status and submit content for indexing.

Examples assume you have signed in and selected the intended organization. Set shell variables such as `ARTICLE_ID` to ids from the corresponding list command. Set `PUBLICATION_TIME` to a future local time in YYYY-MM-DDTHH:MM format.

Badges describe the command’s strongest effect; a preview or read-only option may do less. [Guarded writes can require confirmation even without --yes](https://recala.co/developers/agents/#guarded). “Needs a person” covers identity, consent and credentials.

### [`recala index sitemaps show`](https://recala.co/developers/cli/indexing/#cmd-index-sitemaps-show)

The sitemaps Search Console holds for the site: health, errors, last read.

read Acts on an organization

```
recala index sitemaps show [OPTIONS]
```

Replace [OPTIONS] with the flags you need, or omit it.

| Flag | Required | Description |
| --- | --- | --- |
| `--json` | No | Print one JSON document (errors as JSON on stderr). |
| `--org` | No | Organization name, slug or id (else RECALA_ORG, else recala org use). |

#### Examples

Set the named shell variables to your own values before running.

```
recala index sitemaps show
```

**Exit codes** [`0` OK](https://recala.co/developers/reference/#exit-0) [`1` ERROR](https://recala.co/developers/reference/#exit-1) [`2` USAGE](https://recala.co/developers/reference/#exit-2) [`3` NOT_AUTHENTICATED](https://recala.co/developers/reference/#exit-3) [`4` FORBIDDEN](https://recala.co/developers/reference/#exit-4) [`5` NOT_FOUND](https://recala.co/developers/reference/#exit-5) [`6` CONFLICT](https://recala.co/developers/reference/#exit-6) [`7` INVALID](https://recala.co/developers/reference/#exit-7) [`8` RATE_LIMITED](https://recala.co/developers/reference/#exit-8) [`9` UNAVAILABLE](https://recala.co/developers/reference/#exit-9) [`11` PAYMENT_REQUIRED](https://recala.co/developers/reference/#exit-11)

API commands share the CLI’s HTTP error mapping. [Read human and JSON output rules](https://recala.co/developers/reference/#json-output).

### [`recala index sitemaps submit`](https://recala.co/developers/cli/indexing/#cmd-index-sitemaps-submit)

Resubmit the sitemap to Search Console (needs the connection's write scope; it offers the upgrade).

writes Acts on an organization

```
recala index sitemaps submit [OPTIONS]
```

Replace [OPTIONS] with the flags you need, or omit it.

| Flag | Required | Description |
| --- | --- | --- |
| `--json` | No | Print one JSON document (errors as JSON on stderr). |
| `--org` | No | Organization name, slug or id (else RECALA_ORG, else recala org use). |
| `--feedpath` | No | The sitemap URL (default: the first one Search Console holds). |

#### Examples

Run in your terminal with the intended organization selected.

```
recala index sitemaps submit --feedpath https://example.com/sitemap.xml
```

**Exit codes** [`0` OK](https://recala.co/developers/reference/#exit-0) [`1` ERROR](https://recala.co/developers/reference/#exit-1) [`2` USAGE](https://recala.co/developers/reference/#exit-2) [`3` NOT_AUTHENTICATED](https://recala.co/developers/reference/#exit-3) [`4` FORBIDDEN](https://recala.co/developers/reference/#exit-4) [`5` NOT_FOUND](https://recala.co/developers/reference/#exit-5) [`6` CONFLICT](https://recala.co/developers/reference/#exit-6) [`7` INVALID](https://recala.co/developers/reference/#exit-7) [`8` RATE_LIMITED](https://recala.co/developers/reference/#exit-8) [`9` UNAVAILABLE](https://recala.co/developers/reference/#exit-9) [`10` CONFIRMATION_REQUIRED](https://recala.co/developers/reference/#exit-10) [`11` PAYMENT_REQUIRED](https://recala.co/developers/reference/#exit-11)

API commands share the CLI’s HTTP error mapping. [Read human and JSON output rules](https://recala.co/developers/reference/#json-output).

### [`recala index status`](https://recala.co/developers/cli/indexing/#cmd-index-status)

Google's view of each article: indexed or not, coverage, last crawl, canonical, mobile (cached 24 h).

read Acts on an organization

```
recala index status ARTICLE_IDS [OPTIONS]
```

Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.

| Flag | Required | Description |
| --- | --- | --- |
| `--json` | No | Print one JSON document (errors as JSON on stderr). |
| `--org` | No | Organization name, slug or id (else RECALA_ORG, else recala org use). |
| `--all-published` | No | Every published article (at most 50). |

#### Examples

Run in your terminal with the intended organization selected.

```
recala index status --all-published
```

**Exit codes** [`0` OK](https://recala.co/developers/reference/#exit-0) [`1` ERROR](https://recala.co/developers/reference/#exit-1) [`2` USAGE](https://recala.co/developers/reference/#exit-2) [`3` NOT_AUTHENTICATED](https://recala.co/developers/reference/#exit-3) [`4` FORBIDDEN](https://recala.co/developers/reference/#exit-4) [`5` NOT_FOUND](https://recala.co/developers/reference/#exit-5) [`6` CONFLICT](https://recala.co/developers/reference/#exit-6) [`7` INVALID](https://recala.co/developers/reference/#exit-7) [`8` RATE_LIMITED](https://recala.co/developers/reference/#exit-8) [`9` UNAVAILABLE](https://recala.co/developers/reference/#exit-9) [`11` PAYMENT_REQUIRED](https://recala.co/developers/reference/#exit-11)

API commands share the CLI’s HTTP error mapping. [Read human and JSON output rules](https://recala.co/developers/reference/#json-output).

### [`recala index submit`](https://recala.co/developers/cli/indexing/#cmd-index-submit)

Ping IndexNow (Bing, Yandex, ChatGPT search) for an article and re-check it; prints Google's Request-indexing link.

writes Acts on an organization

```
recala index submit ARTICLE_ID [OPTIONS]
```

Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.

| Flag | Required | Description |
| --- | --- | --- |
| `--json` | No | Print one JSON document (errors as JSON on stderr). |
| `--org` | No | Organization name, slug or id (else RECALA_ORG, else recala org use). |

#### Examples

Set the named shell variables to your own values before running.

```
recala index submit "$ARTICLE_ID"
```

**Exit codes** [`0` OK](https://recala.co/developers/reference/#exit-0) [`1` ERROR](https://recala.co/developers/reference/#exit-1) [`2` USAGE](https://recala.co/developers/reference/#exit-2) [`3` NOT_AUTHENTICATED](https://recala.co/developers/reference/#exit-3) [`4` FORBIDDEN](https://recala.co/developers/reference/#exit-4) [`5` NOT_FOUND](https://recala.co/developers/reference/#exit-5) [`6` CONFLICT](https://recala.co/developers/reference/#exit-6) [`7` INVALID](https://recala.co/developers/reference/#exit-7) [`8` RATE_LIMITED](https://recala.co/developers/reference/#exit-8) [`9` UNAVAILABLE](https://recala.co/developers/reference/#exit-9) [`10` CONFIRMATION_REQUIRED](https://recala.co/developers/reference/#exit-10) [`11` PAYMENT_REQUIRED](https://recala.co/developers/reference/#exit-11)

API commands share the CLI’s HTTP error mapping. [Read human and JSON output rules](https://recala.co/developers/reference/#json-output).