> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inprocess.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Upload a file, upload its metadata, and create a moment in an artist's collection.

Set your artist wallet address and [API key](https://inprocess.world/manage/api-keys):

```bash theme={null}
export ADDRESS=0xYOUR_WALLET_ADDRESS
export API_KEY=art_sk_YOUR_API_KEY
```

## 1. Find your collection

```bash theme={null}
curl "https://api.inprocess.world/api/collections?artist=$ADDRESS"
```

Copy a collection `address` from the response.

```bash theme={null}
export COLLECTION=0xYOUR_COLLECTION_ADDRESS
```

No collection yet? Use `"contract": { "name": "...", "uri": "ar://..." }` in step 4 to create one in the same request. See [Create a moment](https://docs.inprocess.world/api-reference/moment/create.md).

## 2. Upload your file

Send a public URL. The server fetches the file and stores it on Arweave.

```bash theme={null}
curl -X POST https://api.inprocess.world/api/upload \
  -H "Content-Type: application/json" \
  -H "x-api-key: $API_KEY" \
  -d '{"url": "https://example.com/artwork.png"}'
```

```json theme={null}
{ "uri": "ar://FILE_ID" }
```

Files under 5 MB are free for 11 uploads a month. See [Upload files](https://docs.inprocess.world/guides/upload-files.md#cost) for paid uploads.

## 3. Upload the metadata

Write a metadata JSON that points to the file:

```json theme={null}
{
  "name": "My first moment",
  "description": "Work in progress.",
  "image": "ar://FILE_ID",
  "content": {
    "mime": "image/png",
    "uri": "ar://FILE_ID"
  }
}
```

For audio or video, also set `"animation_url": "ar://FILE_ID"` and use a cover image for `image`.

Host this JSON at a public URL and upload it the same way as step 2, or upload it from your app with [`uploadJson`](https://docs.inprocess.world/guides/upload-files#upload-json). Keep the returned URI.

```bash theme={null}
export METADATA_URI=ar://METADATA_ID
```

## 4. Create the moment

```bash theme={null}
curl -X POST https://api.inprocess.world/api/moment/create \
  -H "Content-Type: application/json" \
  -d '{
    "contract": { "address": "'"$COLLECTION"'" },
    "token": {
      "tokenMetadataURI": "'"$METADATA_URI"'",
      "createReferral": "'"$ADDRESS"'",
      "salesConfig": {
        "type": "fixedPrice",
        "pricePerToken": "0",
        "saleStart": "0",
        "saleEnd": "18446744073709551615"
      },
      "mintToCreatorCount": 1
    },
    "account": "'"$ADDRESS"'"
  }'
```

```json theme={null}
{
  "contractAddress": "0x...",
  "tokenId": "1",
  "hash": "0x...",
  "chainId": 8453
}
```

The moment is free to collect and has no end date. To set a price, see [SalesConfig](https://docs.inprocess.world/api-reference/objects/sales-config.md). It then appears on your timeline:

```bash theme={null}
curl "https://api.inprocess.world/api/timeline?artist=$ADDRESS"
```

> [!TIP]
>
> Text only? [Create a writing moment](https://docs.inprocess.world/api-reference/moment/writing.md) uploads the text for you and skips steps 2 and 3.

## Next steps

* [Collect a moment](https://docs.inprocess.world/api-reference/moment/collect.md) with an API key or access token.
* [Agents](https://docs.inprocess.world/agents.md): act for an artist with a 6-digit email code.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.