# Create Signature

[View original](https://ittybit.cloud/api/signatures/create)


`POST /signatures`

You can use signatures to create signed URLs which grant access to your project's resources, without revealing your project's API key. URLs can expire after a specified time and be limited to HTTP `GET` method for read-only access, or HTTP `PUT` method for client-side uploads.

### Parameters

```json
[
  {
    "$ref": "#/components/parameters/AcceptVersionHeader"
  }
]
```

### Request Body

The request body should contain a properly formatted JSON object with a `filename` property. Other optional properties are listed below.

**Schema:**

```json
{
  "type": "object",
  "required": [
    "filename"
  ],
  "properties": {
    "filename": {
      "type": "string"
    },
    "folder": {
      "type": "string"
    },
    "expiry": {
      "type": "integer",
      "format": "unix-epoch"
    },
    "method": {
      "type": "string",
      "enum": [
        "get",
        "put"
      ],
      "default": "get"
    }
  },
  "example": {
    "filename": "video.mp4",
    "folder": "example",
    "expiry": 1735689600,
    "method": "put"
  }
}
```

### Responses

#### 200 - Success

**Example:**

```json
{
  "domain": "you.ittybit.net",
  "filename": "video.mp4",
  "folder": "example",
  "expiry": 1735689600,
  "method": "put",
  "signature": "a1b2c3d4e5f6...",
  "url": "https://you.ittybit.net/example/video.mp4?expiry=1735689600&method=put&signature=a1b2c3d4e5f6..."
}
```