> For the complete documentation index, see [llms.txt](https://docs.fieldmotion.com/fieldmotion-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fieldmotion.com/fieldmotion-api-docs/job/_setjobref.md).

# \_setJobRef

Set a job reference on a Job.

### Parameters

#### id

The ID of the job.

#### value

The job reference.

### Example

```
FM_api('Job_setJobRef', ['id' => '123', 'value' => 'ExampleJobRef']);
```

### Result

#### On Success

```
{'ok':1}
```

If the Appointment already has the job reference:

```
{'ok':1,'warning':'value already set'}
```

#### On Failure

If no Job ID is provided:

```
{'error':'no ID provided'}
```

If no job reference is provided:

```
{'error':'no value provided'}
```

If the Job does not exist:

```
{'error':'appointment does not exist'}
```