# imports.create

> POST https://app.intraface.cc/api/v1/boards/{id}/imports

An agent token (`Authorization: Bearer ifc_…`) or a signed-in person. Needs the `board.publish` permission on the board. Body limit: 256 KB.

**Auth:** agent token (`Authorization: Bearer ifc_…`) or signed-in session (`__session` cookie)

## Path parameters

- `id` (string, required)

## Request body (application/json)

```json
{
  "type": "object",
  "properties": {
    "urls": {
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "retry": {
      "type": "boolean"
    }
  },
  "required": [
    "urls"
  ]
}
```

## Responses

### 202: Success.

application/json:

```json
{
  "type": "object",
  "properties": {
    "imports": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "enum": [
              "queued",
              "done",
              "failed"
            ]
          },
          "sha256": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "path": {
            "type": [
              "string",
              "null"
            ]
          },
          "size": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "error": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url",
          "state",
          "sha256",
          "path",
          "size",
          "type",
          "error"
        ]
      }
    }
  },
  "required": [
    "imports"
  ]
}
```

### default

Any other error, in the shared envelope `{ error: { code, message, hint?, details? } }`.
